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Preface 



This manual explains how to install, configure, and load the DECnet Router Server 
VI. 1 software. More specifically, it explains how to: 

• Install the distribution kit on a host system. 

• Create and modify configuration files for the server software on a host system. 

• Design and configure local area and multiple area networks. 

• Load the software from the host into a Communications Server hardware unit. 

• Check that the software is loaded correctly. 

Intended Audience 

This manual contains information intended for system or network managers responsi- 
ble for making server products available on their Ethernets. System managers are 
persons responsible for setting up the host nodes that will load the DECnet Router 
Server software. The network manager is the person responsible for the local area 
network (LAN) as a whole. Where the DECnet Router Server is to serve as an area 
router, the network manager is also responsible for the multiple area network. 

Structure of this Manual 

This manual has six chapters and three appendixes: 

Chapter 1 Introduces the DECnet Router Server and describes its various func- 
tions, capabilities, and possible hardware and software configurations. 

Chapter 2 Explains how to install the DECnet Router Server software on a DECnet 
host node. 

Chapter 3 Provides guidelines for setting up networks, including Ethernet LANs 
and multiple area networks. It includes guidelines for ensuring that area 
routing works smoothly. 
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Chapter 4 Explains how to configure the DECnet Router Server software. It de- 
scribes the network and routing parameters associated with the DECnet 
Router Server and how you can modify them to suit your needs. It 
includes discussion of the area routing parameters you can define to set 
up the DECnet Router Server as an area router. 

Chapter 5 Explains how to load the software from the host into the Communica- 
tions Server hardware unit. It also explains how to check that the soft- 
ware is operating properly. 

Chapter 6 Explains how to troubleshoot certain problems that can occur when 
attempting to load the server. The troubleshooting procedures can be 
used by non-technical personnel to isolate faults. 

Appendix A Contains a sample line configuration worksheet. 

Appendix B Contains sample configuration files and sample installation and loading 
procedures as performed from a VMS system and from an RSX system. 

Appendix C Contains a summary of the network management (Network Control Pro- 
gram - NCP) commands used for loading and maintaining the DECnet 
Router Server. 

How to Use this Manual 

Before installing the DECnet Router Server software, first read Chapters 1, 2, 3, and 
4, making sure the entire sequence of steps is understood. Before loading the software, 
you may want to change routing parameters to suit the needs of the network. Chapter 
4 describes how to do this. 

Use Chapter 3 to help you set up a multiple area network properly. 
Other DECnet Router Server Document 

• DECnet Router Software Management Guide 

This manual explains how to use network management commands to control and 
monitor the DECnet Router Server. It also describes the tools and facilities avail- 
able for testing the server and for analyzing and troubleshooting problems. 
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Associated Documents 

You should be familiar with the manuals for each host system used to install or 
manage the DECnet Router Server software. For manual titles and order numbers, 
refer to the documentation directory for the operating system. 

The Ethernet Communications Server (DECSA) is documented in the following man- 
uals: 

• Ethernet Communications Server Site Preparation and Planning Guide 

• Ethernet Communications Server Installation Guide 

• Ethernet Communications Server Operations and Maintenance Guide 

You may need to refer to the following manual which describes the Ethernet H4000 
component: 

• H4000 Installation Sheet (be sure to see the manual that applies to your unit, which 
can be 115V or 240V) 

Conventions Used in this Manual 
Conventions Meaning 

Dot Matrix Type Examples of system input and output are printed in dot matrix type. 

Red Print User input in examples is printed in red. Black print is used for system 

prompts and displays. 

UPPERCASE Uppercase letters indicate that the characters must be entered exactly 

as shown. Command keywords can be abbreviated to the first unique 
characters. 

lowercase italic Variables in command lines are printed in lowercase italic type. The 

value is specified by the user. 

brackets [ ] Brackets indicate that the enclosed data is optional. All text not en- 

closed by brackets is required. Do not type the brackets when you enter 
a command. 

braces { } Braces indicate that you must choose one (and only one) of the enclosed 

options. Do not type the braces when you enter a command. 



The use of ellipses means not all the information that the system would 
display in response to a particular command or for a message is shown, 
or that not all the information a user would enter is shown. 

(Hi) A symbol with a 1- to 3-character abbreviation indicates that you press 

a key on the terminal. For example, SH) refers to the RETURN (car- 
riage return) key. 

(ctrl/x) The expression (ctrl/x) refers to a control character keying sequence. The 

key labeled CTRL and the appropriate character key should be pressed 
simultaneously. 
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Introducing the DECnet Router Server and Ethernet 



This chapter introduces the DECnet Router Server and explains concepts you need to 
understand to install the product. 

1.1 What Is the DECnet Router Server? 

The DECnet Router Server is one of a set of Digital software and hardware products, 
called communications servers, that extend the resource sharing and communica- 
tions capabilities of the Ethernet LAN. The DECnet Router Server runs in Digital's 
Ethernet Communications Server hardware unit, which connects directly to the Eth- 
ernet. The DECnet Router Server allows communications between nodes on the Eth- 
ernet LAN and nodes located off the LAN. It performs DECnet adaptive routing 
functions for the nodes on the Ethernet. 

The DECnet Router Server connects to nodes located off the Ethernet LAN by using 
synchronous and asynchronous point-to-point lines. It can support up to 16 synchro- 
nous lines, or 32 asynchronous lines, or various combinations of the two types of lines. 
The DECnet Router Server can support routing to 1022 other nodes, routing and/or 
end nodes. It can support routing to 32 routing nodes on a single Ethernet. The 
maximum number of nodes addressable by the DECnet Router Server depends on the 
number of lines that you configure. See Section 1.2.1. 

In a multiple area DECnet network, the DECnet Router Server supports routing to 62 
other areas, each containing up to 1023 nodes. An area is a group of nodes forming a 
subnetwork. A multiple area network is a large network partitioned into areas. The 
areas are linked by area routers such as the DECnetr Router Server. Section 1.5 further 
discusses area routing and multiple area networks. 
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The adjacent nodes located off the Ethernet (and with which the server can communi- 
cate) may be any of the following: 

• DECnet Router Servers or Phase IV DECnet routing nodes on other LANs. 

The DECnet Router Server permits the systems on the Ethernet LAN to access 
nodes on other Ethernet LANs located in the same vicinity or at a distance (con- 
nected by modem) . In multiple area networks, the remote routing nodes can be level 
1 or level 2 routers. A level 1 router routes data within a single area only. A level 2 
router, such as the DECnet Router Server, can route between areas. In single area 
networks, all routers are level 1 routers. 

• Remote Phase III or Phase IV DECnet routing nodes in a wide area network. 

The DECnet Router Server permits the systems on the Ethernet LAN to access 
nodes on wide area networks. Again, the remote Phase IV DECnet routing nodes 
can be level 1 or level 2 routers. If the remote node is in a different area than the 
DECnet Router Server node, the remote node must be a level 2 router. 

• Remote Phase III or Phase IV nonrouting nodes (end nodes), such as DECnet-RT or 
DECnet/E. 

The DECnet Router Server permits the systems on the Ethernet LAN to access end 
nodes remote from the LAN (connected by modem). 

_ T „ 1 r>U „„„ TTT 
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The DECnet Router Server permits the systems on the Ethernet LAN to access end 
nodes located in the vicinity of the LAN. 

Figure 1-1 shows a DECnet Router Server, RTRDEV, with three point-to-point lines 
connected to other DECnet Phase IV and Phase III routing nodes and end nodes. The 
Phase IV DECnet node CENTER is another level 2 router (an "L2" in figures always 
indicates a level 2 router). RTRDEV and CENTER form a link between areas 2 and 3. 
Within area 3, RTRDEV routes messages between the host nodes on the Ethernet and 
nodes ABLE and CANE. To route messages to nodes in area 2, RTRDEV sends them 
to CENTER. Each node on the local Ethernet can access any nodes on the remote 
networks. 

To enable message routing to nodes located off the Ethernet LAN, end nodes con- 
nected directly to the Ethernet must use a DECnet Router Server or another Phase IV 
routing node connected to the same Ethernet. 



1-2 



DECnet Router Software Installation Guide 



AREA 

2 













III 




CENTER 

L2 




IV 









AREA 
3 



□ D 



□ □ □ 



ABLE 




RTRDEV 




CANE 


IV 






III 




L2 







IV 



IV 



□ — □ 



IV 



IV 



TW008 



Figure 1-1: A DECnet Router Server with Three Point-to-point Lines 

The DECnet Router Server provides Phase IV adaptive routing capabilities. It keeps a 
routing database that contains regularly updated information about the status of all 
destination nodes in the network and about the status of the communications paths 
between these nodes and itself. When the DECnet Router Server receives data from a 
source node, it checks its routing database and forwards the data to the destination 
node along the least costly path. (The system or network manager sets a cost value for 
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Figure 1-2: Two DECnet Router Servers Used in Conjunction on One Ethernet 



each link. The cost of a path between a source and destination node is the total of the 
costs of the links along the path.) The DECnet Router Server uses the updated 
information in its routing database to adapt routing paths to changing network condi- 
tions. For example, when a node along a path becomes unavailable, the DECnet 
Router Server will route messages along another path. 

Phase IV routing capabilities include all those of Phase III routing (including compat- 
ibility with Phase III), plus additional support for RSX and VMS nodes and for other 
communications server products on the Ethernet, and support for area routing, as 
described in Section 1.5. Phase IV routing capabilities also allow network manage- 
ment functions to be performed over the Ethernet, as explained in Section 1.3. 

In summary, the major benefits of the DECnet Router Server are: 

• The DECnet Router Server allows you to configure a large number of nodes on an 
Ethernet as end nodes. The DECnet Router Server provides the routing functions 
for these nodes. Thus, these Ethernet nodes can then share communication lines to 
nodes on and off the Ethernet without burdening intervening host nodes with rout- 
ing responsibilities. Furthermore, these nodes are not burdened with the logical link 
connection processing required for remote communications. This also frees up the 
processing load of the host nodes on the Ethernet. 

• Because the connection of the Ethernet nodes to nodes off the Ethernet LAN is 
through the DECnet Router Server, a unit that is dedicated solely to routing, you 
can realize greater network access and reliability. When connections must be made 
through a timesharing system, which is subject to conflicting demands and variable 
up time, network reliability is not optimal. 

• You can increase the size of the network easily because adding new lines does not 
increase the routing load on other nodes. 

• The DECnet Router Server supports area routing. Area routing allows you to config- 
ure a very large network and increases the efficiency of a large network. 

Thus, the DECnet Router Server is valuable if you have an Ethernet requiring numer- 
ous connections to end nodes and routing nodes located off the Ethernet. The routing 
nodes can be on another Ethernet, in a wide area network, or another area of a 
multiple area network. If there is heavy network traffic between the Ethernet nodes 
and remote nodes, you might consider configuring two or more DECnet Router 
Servers to split the load. For example, if you have 335 nodes on an Ethernet requiring 
extensive communications with nodes on another Ethernet or on a wide area network, 
more than one DECnet Router Server may be required to handle the load efficiently, 
as shown in Figure 1-2, where DECnet Router Servers RTRSV1 and RTRSV2 share 
routing for Ethernet A. 
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1.2 The Communications Server Hardware Configuration 



Digital provides a general purpose, table top unit that supports the DECnet Router 
Server software and other Digital server products. This unit, called the Ethernet 
Communications Server hardware unit, contains a power and cooling system and can 
be used in any typical office or computer room. The Communications Server is cus- 
tomer-installed and easy to maintain. (See the Ethernet Communications Server 
Installation Guide and the Ethernet Communications Server Operations and Mainte- 
nance Guide.) 

Figure 1-3 shows the Communications Server hardware unit. 
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Figure 1-3: An Ethernet Communications Server Hardware Unit 
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The hardware unit contains an intelligent Ethernet controller, called the Ethernet to 
Unibus Network Adapter (DEUNA). The DEUNA provides the interface between the 
Ethernet Communications Server system and the Ethernet. The hardware unit con- 
tains line cards that provide the interface between the DECnet Router Server and 
the nodes that are connected by the point-to-point synchronous and asynchronous 
lines. The line cards connect to an intelligent controller within the hardware unit, 
called a Protocol Assist Module (PAM), that provides access to server memory and 
that implements line control and error recovery procedures. The PAM implements 
the Digital Data Communications Message Protocol (DDCMP) for communications 
over the point-to-point lines on the DECnet Router Server. The Ethernet Communi- 
cations Server can have up to two PAMs. Each PAM can support up to 8 line cards. 

1.2.1 Line Configurations 

The types of line cards supported by the DECnet Router Server product are: 

DCSAX-LA (M3100) A one-line synchronous line card that supports full or half du- 
plex transmission at speeds up to 19,200 bits per second over EIA RS-232C/CCITT 
V.24 lines. 

DCSAX-LB (M3101) A one-line synchronous line card that supports full or half du- 
plex transmission at speeds up to 500,000 bits per second over CCITT V.35 lines. 

DCSAX-LC (M3102) A two-line asynchronous line card that supports full duplex 
transmission at up to 19,200 bits per second over RS-232-C/V.24 lines. 

Figure 1-3 shows both synchronous and asynchronous line cards. 

The Ethernet Communications Server hardware unit supports a variety of line config- 
urations. The aggregate bandwidth of the lines on the unit must be less than 500,000 
bits per second for one PAM, or 1,000,000 bits per second for two PAMs. Calculate the 
aggregate bandwidth by taking the sum of the maximum line speeds. The maximum 
line speed is defined as the fastest clock rate at which the number of devices specified 
can be driven under control of the DECnet Router Server. For example, a one-PAM 
unit can support up to eight high speed synchronous lines (DCSAX-LB) each at a 
maximum of 56,000 bits per second. Optionally, the unit supports one high speed 
synchronous line at 500,000 bits per second for interconnection of two Ethernets. It 
also can support two high speed synchronous lines at 250,000 bits per second. 

A two-PAM unit can support up to 32 asynchronous lines or 16 synchronous lines. The 
maximum configuration assumes each line operates at a maximum of 19,200 bits per 
second. 
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You can mix asynchronous and synchronous line cards within the constraints men- 
tioned above. One PAM can handle a maximum of 8 synchronous lines, or 16 asyn- 
chronous lines. For a mix of synchronous and asynchronous lines, the PAM can 
handle a maximum of somewhere between 8 and 16 lines. For every synchronous line 
(card) on a PAM, the maximum number of asynchronous lines is decreased by two. 
For example, if you choose to include three synchronous lines on a PAM, then the 
maximum number of asynchronous lines for the PAM decreases from 16 to 10. The 
maximum number of lines in this configuration is 13. 

Table 1-1 shows the maximum number of communication lines supported by the 
DECnet Router Server. The aggregate bandwidth is indicated in kilobits per second 
(Kbps). For more information on configuration and performance of the DECnet 
Router Server, see the Software Product Description. The Software Product Descrip- 
tion also lists the supported devices to which the server line cards can be connected. 



Table 1-1: Line Configurations 

Line Speed Number of lines Aggregate 

Bandwidth 

19.2 Kbps 32 asynch 307.2 Kbps per PAM 

19.2 Kbps 16 sync 307.2 Kbps per PAM 

56 Kbps 8 sync 448 Kbps 

250 Kbps 2 sync 500 Kbps 

500 Kbps 1 sync 500 Kbps 

Because of routing database restrictions, a server with 16 synchronous lines or 32 
asynchronous lines will support routing in an area containing as many as 400 nodes. A 
server with up to 8 synchronous lines or 16 asynchronous lines supports routing in an 
area containing 1023 nodes (one of which is the server itself). Because of these limita- 
tions, the distribution kit for installation comes with three system images. Based on 
your installation, the appropriate image will be copied from the kit, as explained in 
Chapter 2. Table 1-2 summarizes the three software configuration options. Each 
option supports routing to other areas. The maximum area size includes the server 
node. 

Table 1-2: Software Configuration Options 
Maximum Lines Maximum Area Size 

8 synch only 1023 

8 synch/16 asynch 1023 
(or mix) 

16 synch/32 asynch 400 
(or mix) 
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The Communications Server supports modem control and modem monitoring so that 
you can include dial-in or leased lines on your server. The Ethernet Communications 
Server Site Preparation and Planning Guide lists the supported modems and cou- 
plers. High speed lines require a modem or modem eliminator. 

See the Software Product Description for more detail on the hardware options. 

While the Communications Server is running, you can remove a line card or replace a 
line card with an identical line card without disrupting communications on the other 
lines. However, you cannot add a line card to a slot that was empty during initializa- 
tion. You must reload the server for the added line to operate. The Software Product 
Description describes other restrictions for configuring line cards. 

1.2.2 Front Panel Switches, Buttons, LEDs and Displays 

The front panel of the Communications Server contains a digital display, several fault 
indicator LEDs (light-emitting diodes), an OFF/ON/LOCK switch, a START button, 
a TEST button, and POWER and RUN lights, as shown in Figure 1-3. Chapter 5 
explains the uses of the front panel LEDs, switch, and buttons for loading the soft- 
ware. When the software is operating normally, the digital display periodically shows 
the 4-digit DECnet node number associated with the Communications Server and 
also displays a cyclic pattern indicating that the software is running. 

1.2.3 Hardware Self-diagnosis 

The Communications Server hardware provides automatic self-diagnosis at startup. 
Self-tests check the hardware unit's connection to the Ethernet network, making sure 
there are no hardware faults that can prevent loading of the software from the loading 
host. The diagnostics use the digital display and LEDs to report the status of any 
failed hardware. 

A longer, more thorough self-test is also available. When the test completes, the 
Communications Server displays its 12-digit Ethernet hardware address (see the 
DECnet Router Software Management Guide). You can load a diagnostic software 
system to check thoroughly the integrity of all hardware components and to run 
repair-level diagnostic tests. 

NOTE 

The DECnet Router Software Management Guide describes these 
diagnostics. The diagnostics are explained in depth in the Ethernet 
Communications Server Operations and Maintenance Guide. 
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1.3 Using Hosts to Load and Maintain the DECnet Router Server 



You can use host nodes on the Ethernet to perform standard network management 
functions involving the DECnet Router Server, such as down-line loading the software 
or performing loopback tests. Most nodes on a LAN can act as a host node for the 
DECnet Router Server. A host node is a multi-function DECnet implementation that 
has disk storage facilities. You can set up one or more host nodes as loading hosts. 
Loading hosts are nodes you can use to down-line load the software across the Ether- 
net to the Communications Server hardware unit. You can use any of the following 
host systems: 

• RSX-11M 

• RSX-11M-PLUS 

• VAX/VMS 

Each of these systems must be running Phase IV DECnet and must be located on the 
same Ethernet as the server. For supported version numbers of host system software 
and DECnet software, see the Software Product Description for the DECnet Router 
Server. A host must have a magnetic tape drive or RL02 disk drive to read the 
distribution media. Also, the host system should have 2700 blocks of disk space to 
store the DECnet Router Server software for subsequent down-line loading. For in- 
stall ation of the software VMS hosts should have 5000 blocks of disk snace. After 
installation, 2700 blocks is sufficient. RSX-11M and RSX-11M-PLUS host nodes 
must support multiuser protection and have access verification support. 

Any one of these hosts can be used for receiving up-line dumps of the server's memory 
after a crash and for receiving event logging messages generated by the server node. (A 
host should have 1024 disk blocks available for each dump.) The host currently 
designated for these purposes is called the DECnet Router Server's maintenance 
host. Normally the maintenance host is the host that loads the server software. If the 
DECnet Router Server is reloaded by another host, then the new loading host be- 
comes the maintenance host. You can choose a host other than the loading host to act 
as the server's maintenance host, but this is not recommended. In addition, you can 
set up other hosts, called backup hosts, to serve as the maintenance host whenever 
the initial maintenance host is not available. You designate the maintenance host and 
backup hosts during installation of the software. 

From Phase IV hosts logically connected to the DECnet Router Server, you can issue 
commands for execution remotely at the server to display status and error informa- 
tion, to control the operation of the server software, and to test network operation. 
Appendix C contains the command formats. The DECnet Router Software Manage- 
ment Guide describes these commands in further detail. 
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1.4 LAN Addressing 



As system or network manager, it is important that you understand how nodes are 
addressed on an Ethernet. With Phase IV DECnet software, a node on an Ethernet, 
such as the DECnet Router Server node, can access a very large number of nodes on, 
and remote from, the same Ethernet. To take advantage of the larger network size 
and Ethernet's high speed data link, Phase IV DECnet software uses an efficient 
addressing scheme for sending messages to other nodes. It can address either a spe- 
cific node or a pre-defined group of nodes on an Ethernet LAN. 

An Ethernet node can send a message to a group of nodes on the LAN by using what is 
called an Ethernet multicast address. The message is sent simultaneously, in one 
transmission, to each node identified by that multicast address. The multicast ad- 
dress is used by the network software for control messages, such as routing control 
messages. The address is not used for user data. Certain network management opera- 
tions involving the DECnet Router Server use the Ethernet multicast address. For 
example, some loopback tests done over the Ethernet send a loop request to the 
Ethernet multicast address. The first node on the Ethernet to respond will loop the 
test data back. See the DECnet Router Software Management Guide for further 
details. As another example, the multicast address is used by the DECnet Router 
Server for requesting potential loading nodes on the Ethernet to down-line load the 
software, as explained in Chapter 5. 

To send a message to a specific node on the Ethernet, the network software uses either 
the node's Ethernet hardware address or its extended DECnet node address. The 
network software uses the Ethernet hardware address before DECnet software is 
loaded on the node. The Ethernet hardware address is a unique address permanently 
associated with each controller hardware interface (Digital or non-Digital) on the 
Ethernet. The address consists of twelve hexadecimal digits, represented in six pairs 
that are separated by hyphens (for example, AA-00-03-00-01-23). You need to spec- 
ify the Ethernet hardware address of the DECnet Router Server when setting up the 
down-line load database on any host that will load the server, as explained in Chapter 
2. To find out the Ethernet hardware address for your server, see Section 2.1. 

The network software uses the node's extended DECnet node address after DEC- 
net software is loaded on the Ethernet node. The extended DECnet node address is 
set up by controller software by appending the node's 4-digit (hexadecimal) DECnet 
node address to a constant 8-digit (hexadecimal) number (AA-00-04-00) that identi- 
fies the node as a Digital Ethernet node. For example, if the 4-digit node address is 
3B-04 (corresponding to the decimal node number of 59), then the extended DECnet 
node address becomes AA-00-04-00-3B-04. If area routing is implemented, node 
addresses must include the area number, a decimal integer indicating the area in 
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which the node is grouped. For example, if the node with node number 59 is in area 2, 
its node address would be 2.59. The extended DECnet node address would be 
AA-00-04-00-3B-08. (The top six bits of the last two hexadecimal digits indicate the 
area.) Section 1.5 includes more information on addressing nodes in multiple area 
networks. 

NOTE 

Single area networks use area 1. 

To find out the extended DECnet node address of your server, see the DECnet Router 
Software Management Guide. 

The 12 -digit Ethernet address that the network software is currently using to address 
a node is called the node's Ethernet physical address. Thus, initially a node's 
Ethernet physical address is its Ethernet hardware address. After DECnet software is 
loaded on the node, its physical address becomes the node's extended DECnet node 
address. The physical address reverts to the hardware address only when the node is 
powered off and powered up again. In this case, the network software uses the node's 
hardware address until the DECnet software is reloaded on the node. 

When running certain circuit loopback tests, you may have to specify a node's Ether- 
net physical address, as explained in the DECnet Router Software Management 
Guide. You must use the proper address (hardware or extended DECnet) 

However, once an Ethernet node becomes a running DECnet system, you will seldom 
need to use the node's Ethernet physical address to identify it. When using network 
management commands, you can identify the node by using the node's DECnet node 
name (or its DECnet node address), providing the node's Ethernet hardware address 
is defined in the down-line load database of the node at which you are issuing com- 
mands. 

1.5 Area Routing 

Phase IV DECnet supports an increased network size. In a single area network, Phase 
IV DECnet increases the maximum size from the 255-node limit of Phase III DECnet 
to a 1023-node limit. Furthermore, a multiple area network can contain up to 62 
areas, each with up to 1023 nodes. The network manager can partition a large network 
into areas to add a second, higher level of routing to your network. Figure 1-4 shows a 
multiple area network. 

The first level of routing, level 1 routing, is the standard routing within a single area. 
The second level of routing, level 2 routing, is routing between areas. All routers 
within a particular area can route data within that area. Level 2 routers, such as the 
DECnet Router Server, can also route data to and from other areas. Each area must 
have at least one level 2 router to connect to other areas. 
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When a level 1 router receives data destined for a node in another area, it uses level 1 
routing to send the data to the nearest node within its own area that performs level 2 
routing. Referring to Figure 1-4 as an example, suppose node GIANT in area 6 wants 
to send data to node MOZART in area 5. When the level 1 router node QBACK 
receives the message, it routes the data to CROWN, the closest level 2 router. In turn, 
CROWN uses level 2 routing to forward the data to a level 2 router in area 5, which in 
this case is node TWORT. Then node TWORT routes the data by level 1 routing to 
node MOZART. Notice the level 2 routers APEX, CROWN, and TWORT, form a 
subnetwork to link the three areas shown in the figure. 

If area routing is not implemented for a network, the whole network is considered a 
single area with the default area number 1. Thus, in a network not divided into areas, 
the DECnet Router Server and other routers perform level 1 routing only. Node 
addresses do not have to include an area number prefix. 

The DECnet Router Server automatically takes on the area number of its loading 
host. You can change the area number at any time. Section 3.3.2.1 explains how to 
define the area number for the server. 

In summary, besides allowing you to configure very large networks, area routing 
provides the following advantages: 

• Increases the efficiency of a large network, even if it contains less than 1023 nodes. 

Setting up a multiple area network reduces routing traffic in the network by res- 
tricting routing overhead between areas to the level 2 routers. Level 1 routers only 
exchange routing information about nodes in their own area. 

• Allows different organizations to manage their nodes separately within a large net- 
work. 

• Makes it easier to merge existing networks. 

The nodes do not have to be renumbered. An area number is added to the number 
of each node to keep their unique identification. 

• If a portion of the network is unstable and generating many routing update mes- 
sages, then area routing can reduce the routing overhead for the rest of the network. 

• If a network has less than 1023 nodes and many of these are Phase III DECnet 
nodes, which have a maximum address limit of 255, then area routing can increase 
the efficiency of the network as a whole. The DECnet Router Server and other level 
2 routers can support a maximum node number of 1023. Assign to each area those 
Phase III nodes that need to talk to each other most. Let each area consist of at 
most 255 nodes so that each Phase III node can address every other node in its area. 
Section 3.3.2.2 provides further guidelines for setting up networks that include both 
Phase III and Phase IV nodes. 
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Figure 1-4: A Multiple Area Network 
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1.6 Ethernet LAN Concepts 



This section defines some Ethernet LAN concepts and terms that you need to know 
for installing the DECnet Router Server. A LAN is a high speed data communications 
network that serves a single building or a limited geographical area, such as an 
industrial complex or college campus. The Ethernet physical channel is a coaxial 
cable. Figure 1-5 shows a simple Ethernet LAN configuration and identifies some of 
the hardware components you may need to work with. 




Figure 1-5: Example of an Ethernet Local Area Network Configuration 

A node is connected to the cable by a cable tap, transceiver, and an intelligent 
Ethernet controller; for example, the DEUNA. 

Each node on the Ethernet receives only those messages addressed to that node, and 
does not have to route messages to other nodes. As a result, communications are not 
hampered by the delay and additional processing that would be needed if messages 
had to be retransmitted at each intervening node, and all nodes are relieved of net- 
work control responsibility at this level. 
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The way an Ethernet LAN is structured means that network operation remains highly 
stable and reliable, uninterrupted by any of the following events: 

• Node failures (unless the node is a routing node providing the only path between 
two or more nodes) 

• Powering nodes on or off (however, momentary interrupts may occur when 
transceivers are connected or disconnected) 

• Connecting or reconnecting nodes at any point on the Ethernet 

The Ethernet LAN structure thus offers great flexibility in a changing work environ- 
ment. 
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2 

Installing the DECnet Router Server Software 



To install the DECnet Router Server, choose a Phase IV DECnet RSX-11M, 
RSX-11M-PLUS, or VAX/VMS host node directly connected to the Ethernet to serve 
as the loading host. RSX hosts must support multiuser protection in RSX and access 
verification in DECnet-RSX. In a multiple area network, choose a host node in the 
same area as the DECnet Router Server. 

NOTE 

This manual uses the term server software to mean the DECnet 
Router Server software used with the Ethernet Communications 
Server hardware unit. 

The manual also uses the term server node to mean the DECnet 
Router Server node. 

The steps for installing the software vary depending on the type of loading host you 
choose. Section 2.2 explains these steps for a VMS host, and Section 2.3 explains 
them for an RSX host. Chapter 5 describes how to load the software and check that it 
works, and how to copy the installation files to another host system. 

The procedure for installing the software is automated. Briefly, it does the following: 

1 Creates an account and directory on the loading host (if these have not already 
been created for a previous server node installation). 

2 Copies files from the distribution medium into appropriate locations on the host. 
The configuration files and command files are copied to the newly created account 
on the host, and all other files are copied to SYS$SYSTEM 
(SYS$SYSROOT:[SYSEXE]) on a VMS host or to NETUIC (or to any special 
server UIC you choose) on an RSX host. 
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3 Sets up the DECnet database relating to the server node on the loading host 
system. This database describes the parameters necessary to load the software 
into your Communications Server hardware unit and, in event of a crash, to 
receive a dump of server memory. (This database is also referred to as the down- 
line load and up-line dump database.) 

4 Sets up the network configuration file. This file sets up software network parame- 
ters used by the server. You define a list of backup hosts for the DECnet Router 
Server and passwords used to access the server node from other nodes in the 
network. A backup host is a substitute for the server's host, used for receiving 
event messages or up-line dumps whenever the main host is unavailable. Backup 
hosts can serve as alternate loading hosts, too. 

5 Sets up the router configuration file, which defines information for the DECnet 
Router Server's routing database and network components. A predefined file, 
supplied with the distribution kit, is used unless you want to tailor it to suit your 
configuration. Chapter 4 explains how to tailor the file. 

After installing the software on the host, you can edit the configuration files at any 
time. Changes take effect when you reload the server software. You can prevent 
unauthorized users from changing, deleting, or copying the configuration files, as 
explained in Section 5.5. 

Optionally, you may wish to configure more than one DECnet Router Server in your 
network. To do so, run a separate, complete installation procedure for each server. 
With each installation, you will build a unique down-line load database and network 
configuration file. After installing each server, edit where necessary its router configu- 
ration file. Much of the software can be shared on the loading host by all the servers. 
For example, the loading host needs only one copy of the loadable diagnostics image 
(LDI). 

DECnet Router Servers having different line configurations may need different sys- 
tem images as well as different installation checkout command files. (The installation 
procedure generates one of three system images, depending on the number of lines on 
the server.) Those servers with similar line configurations can use the same system 
image and installation checkout procedure. 
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2.1 Preparing to Install the DECnet Router Server Software 



Before installing your DECnet Router Server, you should know the installation 
parameters. These parameters should have been established in accordance with the 
network manager and Digital representatives. These parameters are recorded on a 
hardware data worksheet provided with the Ethernet Communications Server Site 
Preparation and Planning Guide. This worksheet, called the line configuration 
worksheet, lists much of the DECnet Router Server information that you will need for 
installing the software. Appendix A presents a sample line configuration worksheet. 
Section 4.2.2 explains how to identify server lines. 

If the installation parameters have not already been discussed with a Digital represen- 
tative, then you must: 

• Understand the topology of an existing network. 

Adding the DECnet Router Server node to a network affects the routing parameters 
in other nodes in the network. The system/network manager should know how to 
modify these routing parameters. The maximum address parameter (defining the 
largest number of nodes that can be addressed by any node) may need to be 
increased. Also, if by adding the DECnet Router Server, the maximum number of 
broadcast routers is exceeded, then the maximum broadcast routers parameter 
should be increased. (A broadcast router is a routing node on the same Ethernet as 
the node.) 

If the DECnet Router Server is to support area routing, you should understand the 
area routing concepts and parameters discussed in Sections 3.3 and 4.3.1. 

• Know how to determine a priority list for backup hosts. 

Backup hosts at the top of the list would normally be reliable systems on the 
network that are usually up and running, not heavily burdened, and having ade- 
quate disk space for an up-line dump (about 1100 disk blocks). 

• Know how to assign a node name and node address to the server node. 

The system/network manager is responsible for coordinating with the system mana- 
gers of other nodes to ensure that all node addresses are unique and that routing 
control parameters provide for efficient data flow through the network. The 
system/network manager should also ensure the uniformity of assumptions about 
network parameter settings such as circuit cost, buffer sizes, and maximum cost and 
hops. In multiple area networks, the system/network manager is responsible also for 
coordinating with the managers of other areas to ensure uniformity among area- 
related network parameters. 
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After you meet the conditions described above, do the following before you install the 
server software: 

• Make sure the Communications Server hardware unit has been installed (see the 
Ethernet Communications Server Installation Guide). 

• Know the DEUNA 12-digit Ethernet hardware address. This is the unique address 
associated with the DEUNA that connects your server to the Ethernet. This address 
uniquely identifies the Communications Server. The installer of the hardware 
should have recorded the address on back of the front panel cover and on the line 
configuration worksheet. 

You can make the hardware unit display this address. With the TEST button in the 
OUT position, push the START button. When the digital display on the front panel 
starts blinking, push the TEST button. After about five seconds, the 12-digit ad- 
dress will be shown on the display, four digits at a time, left to right, in three 
phases. The DECnet Router Software Management Guide shows how the address is 
displayed. The address is also displayed when you run the long self-test for the unit. 

• Back up the distribution kit before changing any of the configuration files. If prob- 
lems arise with a modified configuration, you may want to try loading the software 
with copies of the original configuration files to see if the DECnet Router Server 
operates successfully that way. 

The remainder of this chapter describes how to install the DECnet Router Server. 
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2.2 Installing the Server Software on a VMS Host 



This section describes the automated procedure for installing the DECnet Router 
Server software on a VMS host. To install the DECnet Router Server, your VMS 
loading host must have at least 5000 blocks of disk space available. Once the software 
is loaded and running in the hardware unit, make sure at least 1100 blocks are 
available on the host for receiving each up-line crash dump. 

NOTE 

VMSINSTAL automatically purges files on the loading host. If you 
wish to keep server files that were copied to the host during previous 
server installations, rename those files before invoking VMSINSTAL. 

Invoke VMSINSTAL from the system manager's account or SYS$UPDATE to install 
the software from the distribution kit into the loading host, to set up the DECnet 
database for the server on the loading host, and to set up the configuration files. 

The automated procedure for installing files on a VMS host requires little involve- 
ment beyond answering questions displayed while the procedure (VMSINSTAL) 
runs. Where applicable, the questions display default answers within brackets; for 
example, [UNA-0]. To answer a question with the default (for example, to answer 
UNA-0 where a question displays [UNA-0]), press (BED. Ranges of values that you can 
enter are indicated within parentheses and are separated by a colon. For example, 
(0:16) indicates you can enter a number between and 16 inclusive. 

If you wish to see explanatory text for any question in the procedure, respond with a 
question mark (?). After the text is displayed, the question will be repeated. 

Note that the explanation of VMSINSTAL below deals with the simplest case; it may 
ask other questions depending on your configuration and the products already in- 
stalled. Refer to the Guide to VAX/VMS Software Installation and the Guide to 
Networking on VAX/VMS for more on how VMSINSTAL works. 

To install the distribution kit on your VMS host, log into the SYSTEM account and 
enter the following command: 

$ @SYS$UPDATE:VMSINSTAL CSVRTR device-id 

where device-id identifies the device on which the distribution kit is mounted. 
CSVRTR is the label of the distribution kit for the DECnet Router Server. The 
procedure displays the following text (substituting the real date and time for the 
italics shown below). 

MAX/VMS Software Product Installation Procedure U4,0 
It is date a t time ♦ 

Enter a question mark (?) at any time for help* 



Installing the DECnet Router Server Software 



2-5 



The following warning messages might be displayed. You can ignore them. The proce- 
dure will prompt you for continuing the installation. Answer Y (yes). 



'/.MMSINSTAL-W-DECNET > Your DECnet network is up and running 
'U'MSINSTAL-W-ACTH'E » The following processes are still active: 

* Do y o u want to c o n t i n u e a n y way C N 3 ? 

The procedure will then prompt you for checking your backup. Answer Y (yes) if your 
backup is in place. 

* Are you satisfied with the backup of your system disk C Y E S 3 ? 

Please mount the first volume of the set on device-id: . 

VMSINSTAL displays this request if your distribution kit is on a magnetic tape. 
Mount the volume on the drive that you specified above. When you have mounted the 
volume, answer YES to the following question: 

* Are you read y ? 
The procedure displays: 

AMOUNT- 1 -MOUNTED t CSVRTR mounted on device-id:* 
The following products will be processed: 
CSVRTR Ml . 1 

Beginning installation of CSVRTR Ml.l at time 
'U'MSINSTAL-I-RESTORE > Restoring product saveset A..» 
Router Server M 1 » 1 installation procedures* 

The following set of questions asks you for information used to 
set up the account which will be used to install the Router 
Server software. 

* Device for the account ldev:li 

Specify the device where you want the account located. The default device is the 
running system root device or whatever device you specify as the root for the 
VMSINSTAL installation. 

* DIG for account [014 f 001]: 
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Use a suitable account. 

* How m a n v synchronous lines will be configured ( : 1 G ) C 8 ] : 

* How m a n v asynchronous lines will be configured (0:32) C ] : 

VMSINSTAL uses your answers to these questions to determine which of three sys- 
tem images will be copied to the loading host: 

1 CSVRTR.SYS - 8 line maximum configuration 

Supports a single-PAM hardware configuration with up to eight synchronous 
lines. The system image supports routing for a network of up to 1023 nodes. If you 
respond to the first question above with a number of eight or less, and you respond 
to the second question with (or a ©), this image will be generated for your 
server node. 

2 CSVRTR16L.SYS - 16 line maximum configuration 

Supports a single-PAM hardware configuration with up to 8 synchronous lines, 16 
asynchronous lines, or some combination of both. If your configuration includes 
both synchronous and asynchronous lines, the maximum number of each type of 
line decreases. The image will support routing for a network of up to 1023 nodes. 

3 CSVRTR32L.SYS - 32 line maximum configuration 

Supports a dual-PAM hardware configuration with up to 16 synchronous lines or 
32 asynchronous lines, or some combination of both. The image supports routing 
for a network of up to 400 nodes. 

After you respond to the two questions, VMSINSTAL displays the text below, repeat- 
ing the number (m and n) of each type of line that you specified and indicating the 
maximum configuration being generated (the maximum is denoted by p, which can 
be either 8 or 16), as based on your responses. 

You ha i.i e chose n m synchro n o u s a n d n asynchronous lines* The s y s t e m 
configuration that will be Generated will allow up to p line cards* 

There are 2 lines per asynchronous line card or 1 line per synchronous 
line card* If you wish to add lines to your Router at some later timet 
you should rerun this procedure to Generate the appropriate system* 

If there is already an account named P L U T D t you will receive a 
w ami n d message which v o u m ay ignore. 

7,YMSINSTAL- I -ACCOUNT » Th i s installation creates an account named PLUTO, 
user record successfully added 
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VMSINSTAL has added an account with user name PLUTO to the accounting file. 
The DECnet Router Server's configuration files will reside in this account. 

Installing Router Server V 1 . 1 f i 1 e s ♦ 
Router Server V 1 ♦ 1 files installed! 

The images and command files of Router Server U 1 . i have been 
restored to disk. The next step in the installation is to 
set up the host database. 

The DECnet Router Server software image and other .SYS files have been copied to 
SYS$SYSTEM (SYS$SYSROOT:[SYSEXE]). Command files and configuration files 
have been copied to the PLUTO account in the directory (UIC) on the specified 
device. The command procedure now prompts you for parameters to be used by the 
loading host to down-line load the software and to receive up-line dumps of the server 
memory. 

This command procedure defines the database on your VMS host 
which allows you to down-line load the server software and 
to receive an up-line dump of the server memory after a 
crash. 

This procedure can optionally execute the N C P command file. 

v ivioii> o l njj uses yuui ttiiswcis uu tuc lunuwuig giuup \jl ^ucouuiiS LO SCI Up S 

command file that, when executed, creates the permanent DECnet database for the 
server. The DECnet database for the server is kept on the loading host and contains 
information that the loading host uses to load the software into the Communications 
Server hardware unit and to receive an up-line dump if the server crashes. The 
command file contains NCP DEFINE NODE commands. By default, the NCP com- 
mand file is named seruer-Aiode-id.COM, where server-node-id is the node name that 
you specify in the first question below. More explanatory text and a sample NCP 
command file follow this group of questions. 

♦Server node-id (i-G chars) C] : 

Answer with the name you have chosen for the server node. A node name is a string of 
up to six alphanumeric characters, with at least one character being alphabetic. 

* Server node number (1-1023) CI : 

Answer with the node number you have chosen for the server node. If your server is in 
a multiple area network, its node address automatically takes on the area number of 
its maintenance host. You specify the maintenance host below. Section 3.1.1 discusses 
how nodes are identified in single area and multiple area networks. 

* Hardware address (12 hex-digits) CI s 
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Answer with the 12-digit Ethernet hardware address of the server. This is the perma- 
nent, unique address assigned to the Ethernet UNA controller for the server node. 

Specify the address as a string of 12 hexadecimal digits, with each pair of digits 
separated by a hyphen. For example, AA-BB-CC-DD-EE-FF. 

* Maintenance host (1-G chars) C loading-host-id 1 

Answer with the name of the node that will be the maintenance host for the server 
after it is loaded. If your server is in a multiple area network, the maintenance host 
should be in the same area as the server. This host collects events generated by the 
server and receives an up-line dump of server memory if the server crashes. The 
default host is the loading host. Digital recommends that you use the default initially. 
You can change the maintenance host at a later time by executing the NCP SET 
EXECUTOR command at the server, as explained in the DECnet Router Software 
Management Guide. You can also change the host by specifying another host when 
you load the server with the NCP LOAD command. See Appendix C. 



* Service circuit (UNA-rc) CUNA-O] : 

Answer with the UNA circuit used on the host to connect to the server. 

* Service password (1-1G hex dibits) [ ] 

This password protects the server from being loaded inadvertently. Anyone wanting 
to load the server by command must supply this password. It must match the UNA 
password defined in the server's network configuration file. VMSINSTAL automati- 
cally defines a matching UNA password in the file. 

NOTE 

For security reasons, you may choose not to define the service pass- 
word in the down-line load database, but to define the UNA password 
in the network configuration file. In this way, anyone wishing to load 
the server must specify the password with the LOAD or TRIGGER 
command, as explained in Chapter 5. To define the UNA password in 
the network configuration file, edit the file as explained in Chapter 4. 

* Store file (YES or NO) [YES] ; 

The NCP configuration file may be stored for later use, executed now, or both. If you 
want to store the file, answer YES; otherwise, answer NO. If you answer YES, you are 
asked the following two questions: 

* File name (1-12 chars) C server-node-id. COM3 : 
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I 



a 
m 
o 

Zi 
CD 

r-H 

J3 
O 

c 

CD 
-\ 

C/D 

o 

— H 
*— t- 

J> 

05 
CD 

5" 

CO 

i— H 

E. 

o' 

CD 
c 

q! 

CD 



Server node- i d (1 
Server node n u m b e r ( 



chars) 
1023 ) 



Hardware address 
Maintenance host 
Service circuit 
Service password 
Store file 
File name 
Storage director' 



(12 hex-dibits) 
( 1 - G ) chars) 
( ) 

(1-8 hex dibits) 
(YES or NO) 
(1-12 chars ) 
( ) 



[ ] 
C ] 
[ ] 
CH0ST1 ] 
CLJNA-0] 
[ ] 

r'ES] 

[ R T R D E V 
CSYS$SY 



. COM ] 
SROOT 



[ PLUTO] ] 



RTRDEUdS 
134(H) 

A A - - 3 - - 0-86 (US 



FEFE®) 



Creatine file SYS$S YSROOT : C PLUTO ] RTRDEU . COM 



[NO] 




'ES(H) 



HOST2 



a — □ 




RTRDEV 



TW014 



Figure 2-1: Setting up the DECnet Database for the Server on a VMS Host 



Answer with the name for the NCP command file. 

* Storage directory ( ) [ SYS$S YSROOT : C PLUTO 3 ] : 

Answer with the name of the directory on which you want the file stored. The default 
directory is the root into which you are installing the DECnet Router Server software. 

The following message is displayed when you store the NCP command file: 
Creating file deu : idir* PLUTO 1 server-node-id . COM 

* Execute file (YES or NO) CYES3 : 

Answer YES if you want to execute the NCP command file now to set up the DECnet 
database for the server on the loading host. Answer NO if you want to execute the file 
some other time. Do not answer NO if you have not stored the NCP configuration file. 
If you answer YES, you will see the following two paragraphs of text and possibly the 
error messages: 

NCP will print unrecognized component errors if the node being 
defined is not already defined in the permanent database* Y o u 
may isnore these errors. 

Defining the host database may take anywhere from a few mi n u t e s 
to 30 minutes depending on system load and size of the host's 
node database. 

"L N C P - I - N M L R S P t listener response - Unrecognized component* Node 
XNCP-I-NMLRSP* listener response - Unrecognized component* Node 

Figure 2-1 shows an example of an installer's responses to the above questions. The 
installer is at host HOST1. HOST1 will load the DECnet Router Server RTRDEV. 
The following shows the NCP command file that is set up on HOST1. 



$ 


NCP 


Configuration 


file 


for node r t r d e v 






$ 


n c p 


purge 


n ode 


RTRDEV all 






$ 


n c p 


purge 


n ode 


134 a 


1 1 






$ 


n c p 


define 


n ode 


134 


name RTRDEO 






$ 


n c p 


define 


n ode 


134 


diagnostic file 


c s u 1 d i 


. S V S 


$ 


n c p 


define 


n ode 


134 


dump file SYS$SY 


SROOT : 


C PLUTOHRTRDEU 


$ 


n c p 


define 


n ode 


134 


hardware address 


A A - 


-03- - - 8 G 


$ 


n c p 


define 


n ode 


134 


host H0ST1 






$ 


n c p 


define 


n ode 


134 


service circuit 


UNA-0 




* 


n c p 


define 


n ode 


134 


service password 


FEFE 




$ 


n c p 


define 


n ode 


134 


load file CSORTR.SYS 




$ 


n c p 


define 


n ode 


134 


secondary loader 


PLUTO 


2 . SYS 


$ 


n c p 


define 


n ode 


134 


tertiary loader 


PLUT03 


.SYS 


$ 


n c p 


set no 


de 134 all 
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The server in this example uses the system image for the single-PAM synchronous- 
only configuration (CSVRTR.SYS). Notice that certain parameters are predefined. 
Specifically, these are the name and location of the loadable diagnostics image 
(CSVLDI.SYS), the dump file (seruer-node-id.DMP), and the loader files 
(PLUT02.SYS and PLUT03.SYS). The installation procedure copies all the .SYS 
files to SYS$SYSTEM (SYS$SYSROOT:[SYSEXE]). However, as discussed at the 
end of this section, you can move certain .SYS files to special UICs. Accordingly, 
change the permanent database to reflect the new locations of these files by editing 
the above file (server-node-id. COM) and rerunning it. 

Alternatively, to define or change any parameters in the permanent database, use the 
NCP DEFINE NODE command directly. For example, the following command de- 
fines the same parameter values in the database as does the NCP command file, 
above: 

DEFINE NODE NODE 134 NAME RTRDEV - 

_ DIAGNOSTIC FILE CSVLDI.SYS - 

_ DUMP FILE SYS$SYSROOTs E PLUTO 3 RTRDEV , DMP - 

_ HARDWARE ADDRESS AA-00-03-00-00-B6 - 

_ HOST H0ST1 - 

_ SERVICE CIRCUIT UNA-0 - 

_ SERVICE PASSWORD FEFE - 

_ LOAD FILE CSVRTR.SYS - 

_ SECONDARY LOADER PLUT02 . SYS - 

_ TERTIARY LOADER PLUT03.SYS 

The dashes (-) serve as line continuators. NCP begins the next line with the under- 
score prompt ( ). (See Appendix C of this manual for a summary of the DEFINE 

NODE command and parameters, or see the VAX /VMS Utilities Reference Volume 
for further information on this command.) 

This procedure will now create the Router Server network 
configuration file. 

The network configuration file will be named seruer-node-idSB .CFG 

The network configuration file contains LAN software network parameters used by 
the DECnet Router Server. Chapter 4 describes the parameters in detail and explains 
how to change the parameters. Chapter 4 contains a sample network configuration 
file. 

* System password ( 1 - S c h a r s ) [null] : 

Answer with a string of one to six alphanumeric characters. This will be the network 
privileged password for the server node. Users must specify this password with privi- 
leged network management commands that access the server node. 
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* ClocK frequency (50 or BO) [60] ; 

Answer with the default for installations in the United States or Canada. Answer with 
50 if the site of the installation has a 50 Hz supply frequency. (For example, installa- 
tions in Europe require 50 Hz.). 

The next set of questions asks for backup hosts. 

Y o u m a y enter a maximum of f i v e ( 5 ) backup hosts* 

A null entry or five ( 5 ) entries will terminate solicitation. 

* Backup host (1-6 chars) '[null] : 

Answer with the name of a node that you will use as a backup host node for the server 
node. The backup host node is used whenever the server's maintenance host is not 
available for receiving event messages or an up-line dump. You can specify up to five 
backup nodes. For this reason, the question will be repeated until either you have 
named five nodes, or you have pressed (MD to show that you have no more backup 
nodes to specify. If you do not want to specify any backup hosts, press EH) when the 
question first appears. 

Specify the most reliable backup hosts first. When the server needs to access a backup 
host, it requests access to the first backup node that you specify. If that node is not 
available, the server looks to the next backup specified, and so on. 

On each backup host, make sure you set up a DECnet database relating to the server. 
See the explanatory text, above, which follows the "Execute file" question. 

If your server is in a multiple area network, choose backup hosts from the same area 
as your server. 

Created the configuration file dev. I dir. PLUTO 1 server-node-id SB ♦ CFG 

When this procedure is complete* check and edit (if necessary) the 
router configuration file ( seruer-node-idR T R » C F G ) . 

7, U M S I N S T A L- 1 _ M U E F I L E S > Files will now be moved to their t a r a e t dir ector ies ♦ 
Installation of CS0RTR Ml.l completed at time 

V M S I N S T A L procedure done at time 

You have finished installing the software. The files have been moved to their target 
directories. Before loading the server, you may want to edit the router configuration 
file. A predefined router configuration file was copied to the newly created directory in 
the PLUTO account on the loading host. The file is named server- node-idRTR. CFG, 
where server-node-id is your server's node name. The router configuration file sets up 
routing parameters for the DECnet Router Server. 
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You can use the predefined router configuration file as it is, provided your configura- 
tion matches the defaults defined in the file. Otherwise, edit the file to tailor it to your 
server's line configuration and to define optimal parameter values suitable for your 
network installation (see Chapter 4). 

The predefined file assumes your server has the maximum number of synchronous 
lines supported by the server software image. (The commands defining parameters for 
asynchronous lines are disabled; that is, these command lines are preceded by excla- 
mation points (!), causing the commands to be treated as comments). For example, if 
the software image generated for your server is an image for a single-PAM system, 
CSVRTR.SYS or CSVRTR16L.SYS, the predefined file assumes your server has 8 
synchronous lines. If the image generated for your server is the image for the dual- 
PAM system, CSVRTR32L.SYS, the file assumes your server has 16 synchronous 
lines. 

Appendix B shows two default files, one that is used for a server system supporting a 
maximum of 8 synchronous-only lines, and one for a server system supporting a 
maximum of 8 synchronous or 16 asynchronous lines. 

Now, you can load the DECnet Router Server software, as explained in Chapter 5. 
Section 5.5 explains how to protect the configuration files from being changed, copied, 
or deleted by unauthorized users. 

mi t ttv TOT'Mnm A t i • j i r n ±_ • j. _ j_i 0\70fl>0\70 

±ne v ivioiiNO i /vu proceuure copies uie loiiownig system images uu une oio<poio- 

TEM (SYS$SYSROOT:[SYSEXE]) directory: 

PLUTOCC.SYS This image is used by the Remote Console Facility (RCF, 

described in the DECnet Router Software Management 
Guide). When you invoke RCF from a host, the image is 
loaded into the Ethernet UNA controller on the server node. 

PLUTOWL.SYS This loads PLUTOCC.SYS when RCF is invoked. 

CSVLDI.SYS The Communications Server hardware unit loadable diagnos- 

tic image. 

PLUT02.SYS The secondary loader, used for down-line loading the soft- 

ware. 

PLUT03.SYS The tertiary loader, used for down-line loading the soft- 

ware. 

CSVRTR.SYS, The DECnet Router Server system image. 

CSVRTR16L.SYS 

or 

CSVRTR32L.SYS 
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The procedure copies the configuration files and the following command files to the 
directory in the PLUTO account: 



CSVRTRICP.COM, Installation checkout procedure command file. 

CSVRTR16L.COM, 

or 

CSVRTR32L.COM 

All files and images have world read access. 

Note that the configuration files must reside in the PLUTO account (or the general 
DECnet account on VMS systems). If you move them or edit them, make sure they 
still have world read access or that their owner is PLUTO and has owner read access. 

To test whether the files have sufficient privilege, use the following commands. 

From a VMS host: 

TYPE host-id'TLUTO PLUTO":: file-id 
From an RSX host: 

NFT Tl:=host-id/PLUTOfPLUTO::file-id 

You can move the .SYS files to other directories. For example, you can set up a 
directory for the loader files and system images and another directory for dump files. 
If you move any .SYS files, you must change accordingly the DECnet database 
relating to the server. To do so, edit the server's NCP command file. For the changes 
to take effect in the volatile database of the host, run the command file. 

You have finished installing your software on your VMS host. See Chapter 5 for 
instructions on how to load the server. 
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2.3 Installing the Server Software on an RSX-1 1 M/M-PLUS Host 



This section explains how to install the DECnet Router Server software on an RSX 
loading host. The RSX system must support multiuser protection and access verifica- 
tion. To accommodate the software installation, your RSX loading host must have at 
least 2700 blocks of disk space available. Once the software is loaded and running in 
the hardware units, make sure at least 1100 blocks remain available on the host for 
receiving an up-line crash dump. 

First, you will copy all files on the distribution kit onto any UIC on the loading host. 
Then, you can run the RSXINSTAL command file for the automated installation 
procedure. This command file prompts you for the main parameters needed to install 
your DECnet Router Server. It sets up a special account on the host for storage of the 
configuration and command files, and moves other files to their respective locations. 
It also sets up the network configuration file and prompts you for parameters to be 
used to down-line load the server software or to receive an up-line dump of the server 
memory. You can use RSXINSTAL to install more than one DECnet Router Server. 

If you do not use the RSXINSTAL command file, you must set up a special account 
and directory for the configuration files and command files, and then move these files 
to this new directory. The account must have the user name PLUTO. Section 2.3.2.2 
explains how to set up this account. (If other servers have been installed on the host, 
then the account may already exist.) Move the system files (.SYS) to NETUIC or to 
any other UIC you choose. You must set up a DECnet database for the server on the 
host. Figure 2-2 shows how to set up the database with the Configuration File Editor 
(CFE). Appendix C summarizes the CFE DEFINE NODE command and parameters. 
After using CFE to set up the DECnet database, unload the network and load it 
again. This brings the CFE changes into effect in the host's volatile database. You 
also must set up the network configuration and router configuration files for the 
DECnet Router Server. Chapter 4 explains how to set up these files. 

2.3.1 Copying Files from the Distribution Medium 

The procedure for copying files from the distribution medium depends on whether the 
medium is tape or RL02 disk. The following two subsections describe the procedures 
for each medium. Before proceeding, first move to [40,40] on the host by typing the 
following two commands: 

ASN dev:=SY: 
SET /UIC=[40,40] 

where 

dev. is the device to which the tape will be copied. 

[40,40] is the UIC to where all files will be copied from the distribution medium. 

NOTE 

After copying the files, make sure you protect them from accidental 
deletion. 



Installing the DECnet Router Server Software 



2-17 



2.3.1.1 Copying from a Magnetic Tape — Load the tape on any available tape 
drive. Then mount the tape and copy the files, using the following MCR commands: 

ALL devl: 

MOU devl :/FOR 

BRU 

When BRU has been entered, the BRU> prompt will appear. Then enter the following 
command (shown here with a line continuator) : 

/DENSITY:1600/REWA^ER/NOINI/UFD/OUTVOL:ou^olame- 
/BACKUP_SET:CSVRTR011 

where 

devl: identifies the tape drive from which files are copied. 

outvolume: identifies the output volume, if mounted. 

The BRU utility will display the following prompt: 

From: 

Answer again with the tape drive from which the files are copied. Next, BRU displays: 

To s 

Answer with the device to which the files are copied. 

The BRU utility will display a message at your terminal informing you that all files 
are copied. Now, all files are in [40,40] on your host. To verify that all files are copied, 
see Section 2.3.1.3. 

2.3.1.2 Copying from an RL02 Disk — As a safety precaution, do not use your 
distribution kit as a working disk. First, load the disk on the drive and mount the 
disk, using the following MCR command: 

MOU DLrc:CSVRTR 

To copy the files, use the following Peripheral Interchange Program (PIP) command: 
PIP /NV=DLrc: [40,40]*.* 

where n is the unit number of the RL02 disk drive. 
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2.3.1.3 Verifying All Files Are Copied — If you list the directory, you should see at 
least the following files with the number of disk blocks indicated: 



CSVRTRICP.CMD 4 
CSVRTR16L.CMD 9 
CSVRTR32L.CMD 16 
CSVRTRICP.COM 5 
CSVRTR16L.COM 11 
CSVRTR32L.COM 20 
RSXINSTAL.CMD 24 

All files and images should have world read access. 
You are now ready to run RSXINSTAL. 

2.3.2 Performing RSXINSTAL 

The automated procedure for installing files on an RSX host requires little involve- 
ment beyond answering questions displayed while the procedure (RSXINSTAL) runs. 

Each question displays within brackets the type of response expected and, if avail- 
able, the default. Your responses to RSXINSTAL questions will be one of three types: 

• YES or NO [Y/N] 

• Decimal number [D] 

• String [S] 



CSVRTR.SYS 
CSVRTR16L.SYS 
CSVRTR32L.SYS 
CSVLDI.SYS 
PLUTO WL. SYS 



1016 
1016 
1016 
1002 

5 
6 
5 
7 
2 

19 
23 
28 



PLUTOCC.SYS 
PLUT02.SYS 
PLUT03.SYS 
SB.CFG 



RTR8L.CFG 

RTR16L.CFG 

RTR32L.CFG 
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The default is displayed following a "D:". For example, if UNA-0 is the default, it is 
displayed as follows: D: UNA-0. The default for a yes/no question is NO. To answer a 
question with the default (for example, to answer UNA-0 where a question displays 
UNA-0), press (fU). Questions expecting a number response show the range of valid 
values that you can enter, while questions expecting a string response show the range 
for the string length. 

If you want explanatory text for a question, respond by pressing the (esc) key. After the 
text, the question will appear again. 

To run RSXINSTAL, type the following: 

©RSXINSTAL 

The RSXINSTAL procedure displays the following text. This display includes the 
explanatory text given for each question when you press (He) for help. However, to 
improve readability of the display that follows, the repetition of the question is omit- 
ted after the text. 



Example starts on following page. 
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D E C n e t Router Server Installation Procedure 
Started at time o n date 



Copyright (C) 1384 by 

Digital Equipment Corporation » Maynard t Mass . 



This installation procedure installs the DEC net Router Server (server) 
on a R S X - 1 1 M / M + host* This procedure must be run from a privileged 
account. 



This procedure will create and copy server files. It will create a 
network configuration file based on the answers supplied in section 2 . 
A file named C F E < n o d e > . C M D will contain the C F E c o m m a n d s to define the 
permanent database on this host. 



In other words, when you are setting up more than one DECnet Router Server, you do 
not need duplicates of the software images and loader files. The same image and 
loader files can be used for each server. However, depending on the line configuration 
supported by the additional server(s), you may need to keep more than one system 
image. See the explanatory text for questions 2.00 and 2.01, below. 



■5 Y o u m ay type an escape < ESC > at any question to obtain a d d i t i o n a 1 
5 information about the question* 
? 

5 < E S > Do y o u w ant to: 

* < RET >-Con t in ue > E-Exit [S3; 



> ? Section 1 - General information 

;:-5 = = = = = = = = = = = = = = = = = = = = = = = = = = = : == : = = = = = = = = = = = = = = = = = 

q > 5 Now y o u m u s t decide where you would like to put the various DEC n e t 

m > 5 Router Server files. It is suggested that you pick one uic for the 
O 

CD >; uic for the d u hip images, 



i configuration f i 1 e s t one uic for the loaders and system images and one 



3J ' 

O > 5 NOTE; The uic where the configuration files reside must h a u e a user id 



> and password of PLUTO/ PLUTO ♦ 



> 5 When answering questions in this section p 1 e a s e type the full 
;£ > 5 directory specification* ( D E V : C n n n > n n n ] ) 

i 

CD 

5" 

CO 

r-t- 
E. 

j» 

o 

O 
c 

Cl 
CD 



The last question of this section gives you the option of running the ACNT program to 
add new directories. 
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If you answer YES, RSXINSTAL runs the account file maintenance program 
(ACNT) so that you can add directories. Section 2.3.2.2 explains how to respond to 
the ACNT program. 

> 5 

> ? < EDS > Do y o u w ant to: 

> * < R E T > - C o n t i n u e t R-Repeat section t E - E x i t E S ] 5 

y 5 

> 5 

;:•, = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =: = = = =: = = = = = = = = 

> 5 Section 2 - Building the network confiau ratio n 



This section allows you to determine the system software and network configurations 
for your server. The first two questions ask you for the number of synchronous and 
asynchronous lines on your server. Your responses determine which system image will 
be copied to the loading host, as explained below. The rem aining questions ask you for 
node identification for your server and for LAN parameter values for the network 
configuration file used by the server. Chapter 4 describes the parameters in detail and 
explains how to edit the configuration file to change the parameters. It contains a 
sample network configuration file. 

> * 2 ♦ H o w m a n y synchronous lines will be configured CD R ; . - 1 S . 3 ; 

> * 2.01 How in a n v asynchronous lines will be configured CD R : ♦ - 3 2 ♦ 3 



RSXINSTAL uses your answers to these questions to determine which of three system 
images will be copied to the loading host: 



1 CSVRTR.SYS - 8 line maximum configuration 

Supports a single-PAM hardware configuration with up to 8 synchronous lines. 
The system image supports routing for a network of up to 1023 nodes. If you 
respond to the first question above with a number of 8 or less, and you respond to 
the second question with (or a (HD), this image will be generated for your server 
node. 

2 CSVRTR16L.SYS - 16 line maximum configuration 

Supports a single-PAM hardware configuration with up to 8 synchronous lines, 16 
asynchronous lines, or some combination of both. If your configuration includes 
both synchronous and asynchronous lines, the maximum number of each type of 
line decreases. The image will support routing for a network of up to 1023 nodes. 

3 CSVRTR32L.SYS - 32 line maximum configuration 

Supports a dual-PAM hardware configuration with up to 16 synchronous lines or 
32 asynchronous lines, or some combination of both, and supports routing for a 
network of up to 400 nodes. 



After you respond to the two questions, RSXINSTAL displays the text below, repeat- 
ing the number (m and n) of each type of line that you specified and indicating the 
maximum configuration being generated (the maximum is denoted by p, which can 
be either 8 or 16), as based on your responses. 
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If your server is in a multiple area network, its node address automatically takes on 
the area number of its maintenance host, which by default is the loading host. Section 
3.1.1 discusses how nodes are identified in single area and multiple area networks. 
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2, > 5 If you want more than one backup host enter them separate d b y c o m m a s 

I" >S i.e. H0ST1 »H0ST2 »H0ST3 »H0ST4 »H0ST5 

S> > 5 

° > * 2*07 What are the node-id's of the backup hosts C S 3 : 

> 5 

> 5 Backup hosts are needed when the server's maintenance host is out 

> 5 of service* A D E C n e t Router Server may need to los an event or 

> ? up-line dump a system image* If the maintenance host is do w n t a 

> 5 backup host is needed to assist the D E C n e t Router Server* Be sure 

> 5 to set up the server databases on the backup hosts. Enter the 

> 5 backup hosts as a list. The maximum is five backup hosts. For 

> 5 examples 

> 5 H0ST1 >H0ST2 » H0ST3 >H0ST4 , HOSTS 
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On each backup host, make sure you set up a DECnet database relating to the 
DECnet Router Server. 



If your server is in a multiple area network, choose backup hosts from the same area 
as your server. 

> 5 Building the network configuration file* 

> ! ( deu i L nnn, nnn 3 server-node-idSB .CFG) 

> 5 NOTE: You must also tailor the router configuration file in 

> 5 dev : E nnn, nnn 3 seruer-node-idYi TR.CFG after this procedure 

> 5 completes. 

The router configuration file contains parameters for the routing database used by the 
DECnet Router Server. A predefined file will be copied to the loading host. Before 
loading the server, you can tailor the file to fit your server's line configuration. See the 
explanatory text preceding Section 2.3.2.1. 

> 5 

> * < R E T > - C o n t i n u e > R - R e p e a t section* E - E x i t C S 3 ; 

> 5 

;:-, = = = = = = = = =: = = =: = = = = = =: = = = = = = = = = = = = = = = = = 

> i Section 3 - Moyind the DECnet Router Server files. 

,>5 = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = 

> ? 

> 5 

> ? Copying loaders and system files to deu : C nnn, nnn 3 

> ? 

> ? Copying configuration files 

> 5 server-node-idSQ * CFG and seruer-node-idRl R .CFG 

> ? t o deu s C nnn, nnn 3 
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> u i 1 d i n g the down -line load database 



RSXINSTAL uses your answers to the following two questions to set up a command 
file that, when executed, creates the permanent DECnet database for the server. The 
DECnet database for the server is kept on the loading host and contains information 
that the loading host uses to load the software into the Communications Server 
hardware unit and to receive an up-line dump if the server crashes. The command file 
contains Configuration File Editor (CFE) commands. More text explaining how to set 
up the DECnet database follows these two questions. 

>* 4, 00 What is the loading host's service circuit-id CS D : " UNA -0 " ] : 

> 5 

> 5 This host node may h a u e wore than one active circuit* Y o u m u s t 

> 5 specify the circuit over which service will be performed. 
? 

The loading host's service circuit is the UNA circuit over which the down-line load 
and other service operations will occur. 

>* 4*01 What is the server's hardware address CS1: 

> 5 

> 5 Every Ethernet controller has a unique 12- digit address. This 

> 5 hardware address is displayed by running the long diagnostics self 

> 5 test. This address will be used by the host to service the DECnet 

> ? Router Server* Enter the address as six pairs of digits separated 

> 5 by hyphens ( - ) . 

> 5 



Specify 12 hexadecimal digits. This address is the unique address assigned to the 
server's hardware unit. The address is used to communicate with the server node 
before the DECnet Router Server software has been loaded. 
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You can define these node characteristics in the host's permanent 
database by r u n n i n 3 C F E with the c o m m and file built in this 
procedure ( dev:[nnn,nnn]CFEserver-node-id ♦ CMD ) t as- follows; 

>INS DEV: CNETUICDCFE.TSK 

>CFE 

Enter filename: DEV : [ NETU I C ] CETAB . MAC 

C F E > @dev:[nnn, nnri] C F Eserver-node-id 
C F E > s h o n ode server-node-id 

♦ ♦ ♦ ♦ Displays new node characteristics 
CFEV-Z 



'. E S > Do v o u w ant to; 

R - R e p e a t section t E or < RET > -Exit LSI 



After RSXINSTAL completes, you can run the CFE command file to update the 
permanent database on the host. RSXINSTAL automatically sets up other parame- 
ters in the database by using values you specify in Section 2 of RSXINSTAL, such as 
the server's node name and service password (UNA password). RSXINSTAL sets up 
the loading host as the server's maintenance host. The system images and loader files 
have default names. You determine their location in Section 1 of RSXINSTAL. The 
names and descriptions of each are: 

CSVRTR.SYS, The DECnet Router Server system image. 



For security reasons, you may choose not to define the service pass- 
word in the down-line load database. In this way, anyone wishing to 
load the server must specify the password with the LOAD or TRIG- 
GER command, as explained in Sections 5.1.1 and 5.1.2. 

You can also use the CFE DEFINE NODE command directly to change one or more 
parameters in the permanent database of the host. Figure 2-2 shows how an installer 
uses CFE to set up the database on HOST1 for DECnet Router Server RTRDEV. The 
installer has assigned the system images and files to UIC [100,100] on LB:. By default, 
the host is HOST1; that is, HOST1 will be RTRDEV's maintenance host. Appendix C 
includes the DEFINE NODE command and all the possible down-line load and up- 
line dump parameters. (See the DECnet-RSX System Manager's Guide for further 
information on CFE.) When using CFE directly to set up the database, make sure the 
UICs you specify for parameters correspond to the UICs where you have stored the 
files on the host. 



CSVRTR16L.SYS, 



or 



CSVRTR32L.SYS 

CSVLDI.SYS 

PLUT02.SYS 



The loadable diagnostics image. 

The secondary loader file used for loading the DECnet 
Router Server software. 

The tertiary loader file used for loading the DECnet Router 
Server software. 



PLUT03.SYS 



NOTE 



C F E > D E F I N E NODE 134 NAME RTRDEU - (H 
CFE>DUMP FILE RTRDEU.DMP - dD 

C F E > H A R D W A R E ADDRESS A A - - 3 - - - 8 G - (fH) 
CFE>D I AGNOSTIC FILE LB : [ 1 GO » 1 GO ] CSMLD I . SYS - (H) 
C F E > L A D FILE LB : [ 1 00 , 1 00 ] CSORTR , S YS - © 
CFE>SERUICE CIRCUIT UNA-0 - (H) 
CFE>SERUICE> PASSWORD FEFE - © 

C F E > S E C N D A R Y LOADER LB : C 1 00 , 1 00 ] PLUT02 . SYS - @§T) 

C F E > T E R T I A R Y LOADER LOADER LB : C 1 00 , 1 00 3 PLUT03 . S YS (H) 
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Figure 2-2: Setting up the DECnet Database for the Server on an RSX Host 
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Remember to: 



1 . Edit your router configuration file. 

2 . Update your permanent database with the newly created C F E command 
file. The next time your network is loaded* the volatile database 
on the host will be set up. 

3 . If your volatile database is set up t then you may trigger or 
load the server. If the volatile database is not set lip t then 
down-line load your server with the full NOP com m a n d : 

NOP LOAD NODE server-node-id FROM dev : Lnnn,nnnl CSURTR . SYS SER PASS password 



If the server image installed by RSXINSTAL was CSVRTR16L.SYS or 
CSVRTR32L.SYS, specify that instead of CSVRTR.SYS. Also, use the device and 
UIC that you specified in Section 1 of RSXINSTAL. For the service password, use the 
password specified in response to question 2.04 in Section 2 of RSXINSTAL. 

4 ♦ If you change the synchronous/asynchronous line c o n f i g u r a t i o n f 
you should rerun this procedure to ensure you have the correct 
software image generated for the new configuration. 



D E C n e t Router Server Installation Procedure 
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You can use the predefined router configuration file as it is, provided your configura- 
tion matches the defaults defined in the file. Otherwise, edit the file to tailor it to your 
server's line configuration and to define optimal parameter values suitable for your 
network installation (see Chapter 4). 

The predefined file assumes your server has the maximum number of synchronous 
lines supported by the server software image. (The commands defining parameters for 
asynchronous lines are disabled; that is, these command lines are preceded by semico- 
lons (;), causing the commands to be treated as comments). For example, if the 
software image generated for your server is an image for a single-PAM system, 
CSVRTR.SYS or CSVRTR16L.SYS, the predefined file assumes your server has 8 
synchronous lines. If the image generated for your server is the image for the dual- 
PAM system, CSVRTR32L.SYS, the file assumes your server has 16 synchronous 
lines. 

Appendix B shows two default (predefined) files, one that is used for server system 
supporting a maximum of 8 synchronous-only lines, and one for a server system 
supporting a maximum of 8 synchronous or 16 asynchronous lines. 

If you wish to protect the configuration files from being changed, copied, or deleted by 
unauthorized users, see Section 5.5. 

2.3.2.1 Checking the RSXINSTAL Output — RSXINSTAL moves files to the direc- 
tories you specify, creates the DECnet Router Server's network configuration file 
containing the parameter values you specify, and builds a command file on the host 
that updates the permanent DECnet database relating to the DECnet Router Server. 

To check that all the files have been moved to their proper directories, list each target 
directory. The directory for the system files should contain the following: 

CSVRTR.SYS or CSVRTR16L.SYS or CSVRTR32L.SYS 

CSVLDI.SYS 

PLUTOWL.SYS 

PLUTOCC.SYS 

PLUT02.SYS 

PLUT03.SYS 

The directory for the configuration and command files should contain the following: 

server-node-idSB.CFG 
seruer-node-idRTR.CFG 

CSVRTRICP.CMD or CSVRTR16L.CMD or CSVRTR32L.CMD 
CSVRTRICP.COM or CSVRTR16L.COM or CSVRTR32L.COM 
RSXINSTAL.CMD 

where server-node-id is the node name you assigned to the server. 
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To check the network configuration file, use PIP to type the contents of the file. 
Identify the file with the directory you created for the PLUTO account. For example, 
for server RTRDEV, type: 

>PIP TI ; =RTRDEVSB , CFG © 

In response, PIP displays the file contents, such as: 

SET LINE UNA-0 PASSWORD FFF300 
SET SYSTEM PASSWORD PRIV 
SET SYSTEM LINE FREQUENCY GO 

SET EXECUTOR BACKUP HOSTS HOST 1 » H0ST2 , H0ST3 



To check the permanent database command file created by RSXINSTAL, type the 
contents of CFEseruer-node-id.CMD. For example, for server RTRDEV, type: 

> TYPE CFERTRDEV.CMD (H) 

The following shows a sample display of the command file: 

DEFINE NODE 300 NAME RTRDEV - 
DEFINE NODE RTRDEV - 
SERVICE CIRCUIT UNA-0 - 
SERVICE DEVICE UNA - 

DUMP FILE DB1 ; [100 ,100 3 RTRDEV. DM P - 
HARDWARE ADDRESS A A - 00 - 03 - 00 - 00 - 86 - 
DIAGNOSTICS FILE DB 1 : C 1 00 # 1 00 3 CS OLD I ♦ S YS - 
LOAD FILE DB1 : CI 00 t 1 00 ] CSVRTR . SYS - 
SERVICE PASSWORD FFF300 - 

SECONDARY LOADER DB 1 : C 1 00 , 1 00 3 PLUT02 . SYS - 
TERTIARY LOADER DB 1 : E 1 00 » 1 00 3 PLUT03 . SYS 

Once the permanent database has been updated, use the CFE SHOW NODE com- 
mand to list the parameter values in this database. 

You have finished installing your software on your RSX host. See Chapter 5 for 
instructions on how to load the server. 

2.3.2.2 Creating an Account and Directory on the RSX Host — This section 
explains how to use the account file maintenance program (ACNT) to add new ac- 
counts and directories on a loading host for storage of server system files, dump files, 
or configuration files. You must create a special account for the configuration files, if 
this account has not been created already. The user name for this special account is 
PLUTO. (The required account and directory may already exist from a previous 
installation of a server node. If so, you do not need to create the PLUTO account.) 
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Question 1.03 of RSXINSTAL gives you the option of running the ACNT program to 
add new directories. See Section 2.3.2 of this manual. Because RSXINSTAL auto- 
matically runs the ACNT program, you need not be concerned with the following 
information that tells how to run ACNT. Skip to the information under the heading 
"Responding to ACNT Questions". 

Running ACNT Independently of RSXINSTAL 

To create an account on the host, log on to a privileged account on the host and then 
run ACNT by typing the following: 

>RUN $ ACNT (RET) 

If ACNT was built against the file control services resident library (FCSRES) or fast 
supervisor mode library (FCSFSL), then run ACNT by typing 

>RUN *ACNTRES ® 
or 

>RUN $ACNTFSL (RET) 

accordingly. For more information on ACNT, refer to the appropriate RSX documen- 
tation. 

Responding to ACNT Questions 

The program lists several functions and asks you to select one. Select the Add func- 
tion (A). As the program prompts you, supply the following information: 

1 The identification code (UIC) for the account. 

This serves as the account number. Use a suitable, non-privileged UIC (that is, a 
UIC with a group number of 10 or more). 

2 A password for the account. 

For the directory to hold the configuration files, enter the password PLUTO. 

3 The name of the default system device. 

Respond with the name of the device (physical or logical) that will contain the 
server software files. This must be a device that is always available (usually the 
system disk). Device LB:, or the disk where the network normally resides, is 
recommended. 

4 A first and last name for the new account. 

For the first name, enter any name you choose (up to 12 characters). The last 
name for the account created for the configuration files must be PLUTO. 
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5 The command language interpreter (CLI) to be used. 

Answer with MCR. (Note that ACNT does not ask you for the CLI if your system 
does not support an alternate CLI.) 

6 Whether you want your terminal slaved. 
Answer YES. 

7 On an RSX-11M-PLUS host, ACNT asks for the session identification and ac- 
count number. Refer to the appropriate RSX documentation. 

You have now created an account on the loading host. You can end the ACNT 
program or create another account and directory. 

Set up the PLUTO account so that users cannot log in to it. The following is a sample 
log-in command file that automatically logs off anyone who tries to log ir): 

4 ENABLE QUIET 

♦ OPEN TI: 
.ENABLE DATA 

For security reasons* you cannot lod in to this account* 

♦DISABLE DATA 

♦ CLOSE 
♦XQT BYE 
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Configuring the Network 



Intended for network managers, this chapter gives guidelines for setting up DECnet 
wide area and local area networks. It also describes how to set up networks to include 
area routing support. The guidelines fall into three categories: 

• General guidelines - for all network nodes (Section 3.1) 

• Ethernet guidelines - for all Ethernet nodes (Section 3.2) 

• Area guidelines - for all nodes in a multiple area network (Section 3.3) 

3.1 General Guidelines for Configuring Networks 

The following guidelines describe how you should assign addresses and names to 
nodes so they can be identified uniquely, and how to set up other parameters that 
ensure universality in the whole network. The guidelines are: 

• All nodes in the network must have a unique network-wide address (see Sec- 
tion 3.1.1). 

• All nodes within an area should have the same value specified for the maxi- 
mum node address parameter (see Section 3.1.2). 

• All nodes should use the same buffer size (see Section 3.1.3). 
The following sections describe the guidelines in further detail. 

3.1.1 Identifying Nodes 

Each DECnet node must have a unique node address and, optionally, a unique node 
name. Node addresses are known network wide by the routing function. Node names 
are known only to the network software of each node. To avoid potential confusion, 
give each node a unique name. 
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3.1.1.1 Node Addresses — Node addresses are used by DECnet software to route 
messages. Node addresses consist of two parts: the area number and the node num- 
ber. In networks without area support, the node address must be a number unique 
within the network. Area numbers are not used. In networks with area support, each 
area number must be unique within the network and each node number unique within 
the area. The format of a node address is: 

[area-number. ]node-number 

where area-number must be in the range of 2 to 63 and node-number must be in the 
range of 1 to 1023. You should assign node numbers sequentially, beginning with 1. 
This reduces the size of the databases on routing nodes. You should assign area 
numbers sequentially, also. 

You define the node number of the DECnet Router Server when you install the 
software. When you load the software, the server node automatically takes on the 
default area number of its host, as defined in the down-line load database on the 
loading host. 

You define the node address of VMS or RSX host systems when you configure them. 

When adding area routing support to a network, you will need to change node ad- 
dresses of nodes to reflect their area locations. Section 3.3.2.1 explains how. 

When identifying a node, you can omit the area number. By default, the number of 
the iocai area is used. 

3.1.1.2 Node Names — On each node, assign node names to remote nodes with 
which the node will communicate. These names must not exceed six alphanumeric 
characters; at least one of these characters must be alphabetic. You should try to set 
up the same remote node name list on all nodes. As your network increases in size, the 
bookkeeping associated with network maintenance is much easier if all nodes refer- 
ence remote nodes by the same logical name. 

Remote node names for the DECnet Router Server are automatically set up at the end 
of the software initialization. The server software can set up 1023 node names. The 
software first sets up names for nodes in the same area as the server (called the home 
area), then the names of any adjacent nodes outside of the home area, and finally as 
many names of other nodes as will fit in the database. 

The server software obtains the node names from the remote node name list on the 
server's host node. (The software requests the host to do the equivalent of the NCP 
SHOW KNOWN NODES command.) The node name list on the host is set up when 
generating the DECnet software on the host system. You can add or change node 
names and addresses on the host later. Change them in the permanent database of 
RSX hosts by using the CFE DEFINE NODE command. On VMS hosts, use the 
NCP DEFINE NODE command. To change them in the volatile database of RSX 
and VMS hosts, use the NCP SET NODE command. 
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To change remote node names in the permanent database of the DECnet Router 
Server, first change them in the host and then reload the server. To change them in 
the server's volatile database, you can use the NCP SET NODE command, as ex- 
plained in the DECnet Router Software Management Guide. 

3.1.2 Maximum Address 

All nodes within an area of a multiple area network or within a single area network 
should have the same value specified for the maximum address (also called maximum 
node number) parameter. For Phase III nodes, this guideline may be impossible to 
follow, since Phase IV nodes can address a greater number of nodes. Sections 3.3.2.2 
and 3.3.3.2 give more information on how to handle Phase III restrictions. 

The value used for the maximum address parameter should be greater than or equal 
to all other node numbers. If the maximum value defined on a routing node is too 
small, nodes with numbers exceeding the value will be excluded from the node's 
routing database. 

3.1.3 Buffer Size 

All nodes should use the same buffer size. If buffer sizes of nodes differ, parts of 
messages can be dropped as they are forwarded or received by a node having a smaller 
buffer size than that of the transmitting node. More information about determining 
large buffer size and segment buffer size for the DECnet Router Server is given in 
Section 4.3.1.1. 

3.2 Guidelines for Configuring Ethernets 

If the end nodes on an Ethernet communicate only with each other, no routing node is 
required on the Ethernet. However, if the Ethernet is divided into more than one area, 
an area routing node is required to transport messages between these areas. 

When setting up any routing node on an Ethernet, you must follow the guidelines 
below to ensure proper node operation. These guidelines discuss several parameters 
that you must define for your node. Chapter 4 discusses parameters you can define for 
the DECnet Router Server. For information on defining Ethernet-related parameters 
on other systems, see the appropriate network documentation. The guidelines are: 

• The maximum broadcast nonrouters parameter for any node on an Ethernet 
should be greater than or equal to the total number of nonrouting nodes on all 
Ethernet circuits connected directly to the node (see Section 3.2.1). 

• The maximum broadcast routers parameter for any node on an Ethernet 
should be greater than or equal to the total number of routing nodes on the 
Ethernet circuit connected directly to the node (see Section 3.2.2). 

• The number of routers on an Ethernet should be kept to a minimum (see 
Section 3.2.2). 

The following sections describe these guidelines. 

) 
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3.2.1 Maximum Broadcast Nonrouters 



Define your routing node's maximum broadcast nonrouters parameter so that it is 
greater than or equal to the total number of nonrouting (end nodes) on the Ethernet 
circuit connected to the node. If the parameter is too small, the node may not be able 
to reach some of the end nodes in one hop. (They will be reachable through other 
routers on the Ethernet.) Section 4.3.1.6 explains how to define the maximum broad- 
cast nonrouters parameter for the DECnet Router Server. 

3.2.2 Maximum Broadcast Routers 

Define your routing node's maximum broadcast routers parameter so that it is greater 
than or equal to the total number of routers on all Ethernet circuits connected to the 
node. If the parameter is too small, the node may not be able to reach some of the 
routers in one hop. (They will be reachable through other routers on the Ethernet.) 

For the DECnet Router Server, define the maximum broadcast router parameter as 
explained in Section 4.2.1. 

Keep the number of routers on a single Ethernet to a minimum. The larger the 
number of routers, the greater the overhead for each router. Routers generate traffic 
among themselves, especially when nodes are becoming unreachable. The traffic in- 
creases as the number of routers increases. If possible, keep no more than 10 routers 
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to insure that routing remains uninterrupted if one router goes down. 

If your Ethernet requires numerous connections to nodes off the Ethernet or on other 
Ethernets, add one or more DECnet Router Servers to the Ethernet. As a unit dedi- 
cated solely to routing, the DECnet Router Server can route without having to attend 
to other functions that burden conventional routing nodes. This increases the accessi- 
bility and reliability of your network. You can configure the other nodes on the 
Ethernet as end nodes. Leaving routing to the DECnet Router Server, the end nodes 
can dedicate themselves more fully to applications or other processing functions. 

3.2.3 Ethernet Routers and End Nodes 

As mentioned previously, all nodes on an Ethernet can communicate directly with 
each other without depending on intervening routing nodes. Initially, however, end 
nodes on an Ethernet do not have information about other nodes on the network 
except for the designated router (if there is one) on the Ethernet. An end node uses 
the designated router when communicating with any node for the first time. 

If the destination node is a node on the same Ethernet as the source node, the 
designated router informs the source node. Then, subsequent communications with 
this node can be direct. All end nodes keep a cache of nodes which they may address 
directly on the Ethernet. If the destination node is not on the Ethernet, subsequent 
communications with this node will occur through the router (on the Ethernet) that is 
on the optimal path. 
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If there are two or more routers on the same Ethernet, the network software on all 
routing nodes on the Ethernet elects one of them as the designated router. The 
election is made on the basis of the highest numerical priority, a number which is 
defined on each routing node as an Ethernet circuit parameter. In case of ties, the 
router with the highest node address is elected. (To define the circuit priority parame- 
ter for the DECnet Router Server, see Section 4.3.2.3.) 

When there is no router on the Ethernet circuit, the end node wishing to communicate 
with another node sends the message directly, hoping that the other node is there. If 
the destination node is on the Ethernet, it informs the source node. The source node 
then adds the destination node to its cache and sends subsequent messages directly to 
the destination node. If the destination node is not on the Ethernet, communication 
will not be possible. End nodes on the Ethernet must use a router to communicate 
with nodes off the Ethernet. 

3.3 Guidelines for Configuring Area Networks 

As network manager, you can set up a large network of more than 1023 nodes by 
dividing it into smaller networks called areas. The entire network can consist of up to 
62 areas, each containing up to 1023 nodes. Even if your network consists of fewer 
than 1023 nodes, you can benefit by splitting your network into areas, as explained 
below. Figure 3-1 shows a multiple area network. You can take an existing large 
network and partition it into areas, or you can take existing networks, designate them 
as areas, and combine them to form the larger multiple area network. Section 3.3.2 
explains how to configure a multiple area network. 

Areas are linked by routers such as the DECnet Router Server that support Phase IV 
DECnet area routing. These routers are called area routers or level 2 routers, and 
they perform routing on two levels. On one level, they perform the standard routing 
within their own area, as performed by Phase IV or Phase III DECnet routers. This 
level of routing is called level 1 routing. On a second level, they route data between 
areas. This level of routing is called level 2 routing. 

In Figure 3-1, nodes APEX, TWORT, and CROWN are level 2 routers. They link the 
three areas of the network. Notice that the level 2 routers are connected so that they 
form a network of their own. (In the figure, the network of level 2 routers is 
highlighted in red.) Section 3.3.1 includes guidelines for setting up level 2 routers in 
a multiple area network. Level 1 routers route data within a single area only. When 
level 1 routers receive data destined for another area, they route the data to the 
nearest level 2 router in their own area. In turn, that level 2 router routes the data to 
the nearest level 2 router in the destination area. In a network that is not a multiple 
area network, all routers are considered level 1 routers. 

Area routing provides several advantages: 

1 Allows for larger networks, exceeding 1023 nodes. 

2 Minimizes the routing overhead for the network. 

3 Management of the network becomes easier. 
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Figure 3-1: A Multiple Area Network 
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Area routing can benefit a network of fewer than 1023 nodes, too. For example, if you 
have a network of 1000 nodes, the routing overhead incurred by each routing node can 
become burdensome. By dividing your network into areas, such as five areas of 200 
nodes each, the overhead for routing between areas will be restricted to level 2 routers 
only. With less routing traffic, your network will gain in efficiency. Also, by dividing 
your network into areas, it will be easier to manage. 

As another example, suppose you have a network of fewer than 1023 nodes and many 
of these nodes are Phase III DECnet. Because Phase III DECnet nodes have an 
addressing limit of 255, many nodes will be unable to communicate with each other. 
You can divide the larger network into groups (areas) of nodes, each group containing 
fewer than 255 nodes. Keeping in mind that the Phase III nodes can communicate 
with nodes in the same area only, assign to each area those nodes that need to 
communicate with each other. To ensure that all the Phase III nodes within an area 
can communicate with each other, renumber all nodes in the area so that all node 
numbers are less than 255. Section 3.3.2.2 provides rules you should follow when 
setting up a multiple area network that includes Phase III nodes. 

Other advantages of area routing have been described in previous sections of this 
manual. The following section describes the properties and functions of level 1 and 
level 2 routers within a multiple area network. 

3.3.1 Level 1 and Level 2 Routers 

An area can contain many level 1 routers and end nodes, and must contain at least 
one level 2 router to provide the connection to other areas. A level 1 router keeps 
information on the state of nodes within its own area. It cannot have any circuits 
outside its own area. Level 1 routing nodes and end nodes access nodes in other areas 
through a level 2 router residing in their own area. 

A level 2 router keeps information on the state of nodes in its own area and also 
information on the cost and hops involved in reaching other areas. The level 2 router 
always routes data over the least cost path to a destination area. Level 2 routers have 
the following characteristics: 

• Level 2 routers connect areas together. 

• Level 2 routers also act as level 1 routers within their own area. 

• Each level 2 router in a network must be physically connected to at least one other 
level 2 router. All level 2 routers must be connected in such a way that they create a 
network of their own. (See Figure 3-1.) Within an area, there must be a level 2 path 
between any pair of level 2 routers. 

When a level 2 router finds that it has no links to other level 2 routers, (either in its 
own area or in other areas), it automatically stops claiming to be a level 2 router. It 
functions as a level 1 router only. Conversely, when the level 2 router finds that 
links to other areas are active, it begins to claim to be a level 2 router. 

• Level 2 routers exchange level 2 routing messages among themselves. 

• In any given area, there can be more than one level 2 router. 

• Each level 1 node decides which level 2 router is nearest on the basis of cost. 
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You should configure several level 2 routers in the same area to provide redundancy. 
In this way, when one of the routers is unavailable, routing to and from other areas 
can continue through the other level 2 router(s) . Provide for alternate paths between 
nodes in the same area so that the loss of one path does not prevent the flow of level 2 
routing traffic through the area. 

Note that if two or more level 2 routers exist in the same area, each level 1 router 
sends data destined for other areas to the nearest level 2 router. The level 1 router 
selects the nearest level 2 router on the basis of path cost to the level 2 router, 
irrespective of which level 2 router is closest to the destination area. The level 1 router 
has no access to this information. 

3.3.2 Configuring a Multiple Area Network 

You can divide a network into a maximum of 62 areas, with each area containing up 
to 1023 nodes. Areas must be distinct: a node cannot belong to more than one area. 

Assign an area number (integer) to each area, starting with 2 and incrementing by 1. 
(Area 1 can be used. However, it is recommended that you do not use area 1 in 
multiple area networks. Area 1 is reserved for networks without area support or in 
transition to multiple areas.) Note that the node number must be unique within an 
area, but may be used again within another area. Thus, node identification within one 
area is independent of node identification in another area. If you combine two or more 
networks to form a multiple area network, you do not have to renumber ail the nodes 
to maintain their unique identities. For example, node 211 in area 3 is identified as 
3.211, while a node 211 in area 16 is uniquely identified as 16.211. 

To add area support to a standard network, follow the steps outlined in Section 
3.3.2.1. Section 3.3.2.2 contains guidelines for designing multiple area networks. Fol- 
low these guidelines whether you are upgrading a standard network or building a 
multiple area network from scratch. 

3.3.2.1 Upgrading a Single Area Network to a Multiple Area Network — Con- 
verting an existing single area network to a multiple area network requires careful 
planning. Because the network addresses of existing nodes will change, there may be a 
period of partial connectivity while the conversion is underway. To upgrade a stand- 
ard network to a multiple area network, follow these three steps: 

1 Decide on the new network topology, using all the guidelines in Section 3.3.2.2. 
Decide which nodes should be level 2 routers, level 1 routers, and end nodes. 

2 If the new design entails repositioning nodes, make the required changes before 
you begin converting node addresses. For example, the redesign may require re- 
connecting a Phase III node so that it is not in a path between two Phase IV nodes. 
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3 Create new node databases, reflecting the new layout. The major changes are 
discussed below. (On VMS nodes, this can be done in a separate directory using 
logical names so that the current database will not be disturbed until you are 
ready to replace it.) The major changes to make to the permanent database of 
each node are: 

• Establish area support on each node, starting with the level 2 routers. Establish 
area support by redefining each node's address to correctly reflect its area. For 
the DECnet Router Server, you do not have to redefine its node address manu- 
ally. First, redefine the node address of the server's host in the down-line load 
database of the loading host, then reload the server. The server's node address 
automatically takes on the area number of the host. If you want to define your 
DECnet Router Server as a level 2 router, then before reloading the server 
software enable the area routing commands in the router configuration file, as 
explained in Section 4.3.1. 

To redefine the node address of a VMS system to reflect the area in which it 
resides, use the NCP DEFINE EXECUTOR ADDRESS command. The DE- 
FINE command sets the address in the node's permanent database. For the 
address to take effect in the volatile database, you must bring the network down 
and back up again. Use either the SET EXECUTOR STATE SHUT or SET 
EXECUTOR STATE OFF command to bring the network down. When you use 
the SET EXECUTOR STATE SHUT command, communications on all cur- 
rently established links are allowed to complete before the network comes down. 
The SET EXECUTOR STATE OFF command brings the network down imme- 
diately. 

For example, if node 211 is assigned to area 16, redefine the node address by 
typing the following commands at the node: 

$ NCP> DEFINE EXECUTOR ADDRESS 1G ♦ 21 1 (fifD 
$ NCP> SET EXECUTOR STATE SHUT (RET) 

Then type the following to bring the network up again: 

$ 0STARTNET © 

To redefine the node address of an RSX host node, use the CFE DEFINE 
EXECUTOR ADDRESS command and reload DECnet on the node. 
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• Define the level 2 routers. Any DECnet Phase IV routing node can be upgraded 
to a level 2 router. Level 1 and level 2 routers, are distinguished by the TYPE 
parameter in the node's executor database. The node type of level 1 routers is 
ROUTING IV. The node type of level 2 routers is AREA. On the DECnet Router 
Server, the parameter is automatically set up after you load the software. To 
establish the DECnet Router Server as a level 2 router, enable the area routing 
commands in the router configuration file before you load the software, as ex- 
plained in Section 4.3.1. 

To define a VMS host system as a level 2 router, type the following commands: 

NCP> DEFINE EXECUTOR TYPE AREA (RED 
NCP> SET EXECUTOR STATE SHUT © 
IMCP> SET EXECUTOR TYPE AREA © 
NCP> SET EXECUTOR STATE ON © 

The DEFINE EXECUTOR command defines the routing type in the executor's 
permanent database. The SET EXECUTOR command defines it in the execu- 
tor's volatile database. As shown, you must bring the network down (SET 
EXECUTOR STATE SHUT) before using the SET EXECUTOR command, 
then bring the network back up again afterward. 

To define an RSX host system as a level 2 router, regenerate the node and 
specify the routing type during the generation procedure. 

• On each node, redefine the remote node names, assigning the correct area num- 
bers for the network. This step is unnecessary for the DECnet Router Server 
node. 

• Define transmit passwords for Phase III nodes connected to Phase IV nodes. The 
transmit password on the Phase III node must match the receive password for 
the adjacent Phase IV node. See the discussion in item 9 of Section 3.3.2.2 

NOTE 

For VMS systems, you do not have to reboot the operating system to 
activate the changes in the permanent database. You merely shut 
down DECnet and bring it up again. Use the following command to 
bring down the DECnet: 

NCP SET EXECUTOR STATE SHUT 

Type the following command to bring it up again: 

$@STARTNET 
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4 If you can take down an entire network or area to upgrade each node, do so. If you 
cannot shut down all nodes simultaneously, such as in an environment that can- 
not tolerate massive disruption of the network, some nodes will not be able to 
interconnect until all nodes have been brought up with the new database. 

Note that if your node is on an Ethernet to which applications other than DECnet 
are connected, such as the Local Area Transport (LAT) protocol used for commu- 
nication with Terminal Servers, these applications should also be shut down along 
with DECnet, and then restarted after DECnet is restarted. This step is necessary 
because DECnet will be changing the Ethernet physical address of your node to 
reflect the new executor node address. 

5 Use NCP SHOW commands to monitor the reconfigured network. (See Appendix 
C for command format summaries. For more information, refer to the DECnet 
Router Software Management Guide.) 

Depending on the size of the network and the care with which the conversion is done, 
there may be a period of debugging the network to ensure that the desired level of 
connectivity has been achieved. You can simplify debugging the conversion if you can 
run each area separately for a while before connecting them together. You can do this 
by turning off the circuits between level 2 routers in different areas. Once you are 
confident that an area is operating to your satisfaction, you can turn on the circuits 
joining this area to its neighboring areas. Of course, while the interarea circuits are 
off, nodes in those areas will not be accessible. View this circumstance as a tradeoff to 
reduce the number of variables during conversion. 

3.3.2.2 Designing Multiple Area Networks — Use the following guidelines when 
designing multiple area networks. 

1 First, design the level 2 routers, area by area, into a level 2 subnetwork. Then, in 
each area, add the level 1 routers. Finally, add the end nodes required to complete 
each area. Do not connect the areas together until you have configured all areas in 
the network, as explained previously, and they are running and stable. 

2 Each node must belong to one area only. This applies to Phase III and Phase IV 
nodes alike. 

3 Only level 2 routers can be one hop away from a node in another area. That is, 
only level 2 routers can have a link connecting any two areas. 

4 The network of level 2 routers must be physically intact. Paths between any two 
level 2 routers should include level 2 routers only. If a path includes a level 1 
router, the level 2 routers will not be able to exchange level 2 routing information 
because level 1 routers filter out such information. 
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5 Configure all level 2 routers as a "backbone" network, then tie all of the areas to 
it. Remember that the level 2 routers must form a subnetwork so that each level 2 
router directly connects to another level 2 router. Level 1 routers or Phase III 
nodes cannot form a part of the path between two level 2 routers. To ensure 
reliable area routing, provide more than one path between level 2 routers within 
the same area. (See Section 3.3.3.1.) 

6 Treat each area as a separate network. Connect each node in an area so that it can 
communicate with all other nodes within the same area. The nodes need not be 
physically adjacent, but should have at least one physical path that lies totally 
within the area. Each area must be physically intact. Do not have overlapping 
areas. 

7 Provide enough redundancy in each area to handle failures of links and nodes. As 
mentioned in Section 3.3.1, it is advisable to set up several level 2 routers in each 
area to prevent disruption of area routing when a single level 2 router goes down. 

8 All Phase III routing nodes are treated as level 1 routing nodes, with some import- 
ant restrictions: 

• All Phase III nodes (both routing and nonrouting) can communicate only with 
nodes within the same area. Phase III nodes must not have any circuits that 
cross over to other areas. In other words, a Phase III routing node must not have 
direct connections to (that is, should not be one hop away from) nodes in other 
areas. 

• All Phase III routing nodes can communicate only with nodes for which they can 
maintain routing information. Phase III nodes cannot address nodes with a node 
address greater than 255. Therefore, Phase IV nodes with an address greater 
than 255 are "invisible" to Phase III nodes in the same area. As explained 
previously, this is a good reason to break a network into areas (each area not 
exceeding 255 nodes), even if the network contains fewer than 1023 nodes. 

• Place all Phase III nodes on the periphery of the network. Avoid having a Phase 
III node on a path between two Phase IV nodes with addresses exceeding 255. 
Phase III nodes cannot be connected directly to an Ethernet. 

Section 3.3.3.2 describes in further detail restrictions applying when Phase III nodes 
are included in a multiple area network. 
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9 It is possible for communications to occur inadvertently across area boundaries. 
This can happen when a Phase III node is connected to a node outside its own 
area. For example, node DAMION in Figure 3-2 is a Phase III node with a link 
between areas 3 and 4. Because of the way a Phase III link handles an incoming 
node address (it drops the area number), DAMION will build a routing database 
containing nodes ABLE, CANE, and EAGLE, including their node addresses 
minus their area numbers. 

DAMION will send routing updates about ABLE and CANE across the area 
boundary to EAGLE. Because the node addresses of ABLE and CANE sent to 
EAGLE will not include the area number, EAGLE will think that ABLE and 
CANE are in its own area. Likewise, ABLE and CANE will think EAGLE is in 
their own area. In this way, nodes ABLE and CANE will be able to communicate 
with EAGLE, and vice versa. Though this kind of configuration actually works in 
some cases, it can pose difficulties to troubleshooters when it does not work. 
Therefore, do not configure your network in this way. 

Phase IV DECnet provides a way for you to prevent such interarea leakage as 
described above. Before a link can be established between a Phase III and Phase 
IV node, the Phase IV node requires a node level password (transmit password) 
from the Phase III node. If the Phase IV node does not receive the required 
password, the link will not be established (the circuit will not come up). The 
event-logging facility records this as an error message, indicating that a password 
is required or is mismatched. 

This helps you locate interarea links between Phase III and Phase IV nodes. You 
can learn which Phase III nodes have not been initialized. You can use this 
information to prevent Phase III nodes from linking to nodes outside their own 
areas, or to identify which Phase III nodes need to have the transmit password set. 
Note that this technique will not locate Phase III nodes that are improperly linked 
to nodes in other areas if the Phase III nodes were configured using node level 
passwords prior to area conversion. 

Thus, when you are sure your network is configured properly, define transmit 
passwords for all Phase III nodes and receive passwords for Phase IV nodes. 
Section 4.3.1 explains how to define the receive and transmit passwords for your 
DECnet Router Server. The server's receive password should match the transmit 
password of any Phase III node connected to it. 
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10 Areas should reflect expected traffic flow. That is, assign nodes to areas according 
to the frequency of their intercommunications or their likeness of logical func- 
tions. Although this guideline is not as strict as the previous ones, by following it 
you will greatly improve overall network performance. Routing within areas is less 
costly than routing between areas. Thus, areas should reflect not only physical 
proximity of nodes, but a combination of physical and logical proximity. 

11 Do not use areas to enforce protection. Although at first glance the concept of 
areas seems to offer penetration protection across areas, the DNA architecture 
does not specify protection guarantees for areas. (See Figure 3-2 and the discus- 
sion of area leakage, above). Therefore, do not assume such guarantees when you 
set up your multiple area network. 
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Figure 3-2: Area Leakage 



3.3.2.3 Area Routing on an Ethernet — You can set up multiple areas on an 
Ethernet; all the nodes on a single Ethernet do not have to be in the same area. 
However, try avoiding such configurations where possible; otherwise, the message 
overhead for routing nodes on the Ethernet increases significantly. When two end 
nodes or level 1 routing nodes on an Ethernet are configured in different areas, the 
nodes do not communicate directly with each other. Each node first communicates 
with a level 2 router in its own area, which sends the message to a level 2 router in the 
other area. That level 2 router then transmits the message to the destination node. 



3-14 



DECnet Router Software Installation Guide 



3.3.2.4 Area Parameters — The following parameters must be defined on all level 2 
routing nodes. 

MAXIMUM AREA 

This limits the number of areas that the node will recognize. 
MAXIMUM AREA COST 

The node uses this parameter to control the total path cost between itself and the 
nearest level 2 router of each area. 

MAXIMUM AREA HOPS 

This parameter sets the maximum number of hops that a message can make between 
itself and the nearest level 2 router of each area. 

Chapter 4 (Section 4.3.1) explains how to define these parameters for the DECnet 
Router Server. See the appropriate host system DECnet documentation for informa- 
tion about defining these on VMS or RSX host systems. 

Use the NCP SHOW EXECUTOR CHARACTERISTICS command to display the 
current values of these parameters in the volatile database of a node. You can use the 
NCP SHOW AREA command to obtain information about areas known to a node. 
The DECnet Router Software Management Guide explains how to use these NCP 
SHOW commands. 

3.3.3 Problems in Configuring Multiple Area Networks 

This section includes some typical problems that may arise when configuring a multi- 
ple area network and offers some suggestions to help you avoid and fix those prob- 
lems. 

3.3.3.1 Improper Configuration of Routing Nodes within an Area — If a multiple 
area network is configured improperly, network traffic may be routed incorrectly or 
lost. Figure 3-3 shows an improperly configured area in which a node can be isolated 
within an area. This problem is called area partitioning, where an area is vulnerable 
to partitioning as a result of failure of a single line. 

Assuming each link cost is 1, then if link c or d is down, the following can happen: 
Assume we want data sent from node YAP in area 3 to node ZILOG in area 4. The 
level 2 router in area 3, XYLO, will determine the least cost path to a level 2 router in 
area 4, which is the path from YAP to XYLO to WHIRL. But, if link c or d is down, 
then ZILOG will be isolated. On an initial attempt to connect to ZILOG, YAP will 
receive a "Node unreachable" message. If link c or d breaks after YAP and ZILOG 
have established a link, a timeout will occur. 
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Figure 3-3: Improper Router Configuration within an Area 



Another problem can occur with the configuration shown in Figure 3-3. If link d is 
down and node ZILOG wishes to create a link to node XYLO, node ZILOG will choose 
a path through area 2 and then to XYLO. However, when XYLO tries to send a return 
message, the same problem will occur as described above. 

To prevent the above problems when configuring your area network, remember to 
treat each area as a separate network. Where possible, each node should have alter- 
nate paths to other nodes, and all level 2 routers in an area should be connected by 
level 2 paths. In Figure 3-3, the network in area 4 is poorly configured because only 
one path can be used by each node to reach another node in its area. Also, a level 1 
router is on the path between two level 2 routers (ARP is between ZILOG and 
WHIRL). One way to fix the above problems is to install a link between ZILOG and 
WHIRL. 

3.3.3.2 Phase III and Phase IV Coexistence — As mentioned previously, try to 
upgrade all Phase III nodes to Phase IV where possible. If you must have Phase III 
nodes, be careful how you configure them. Section 3.3.2.2 has shown what happens 
when you set up a Phase III node with a link into another area (Figure 3-2). The 
following shows the problems that occur when you place a Phase III routing node on a 
path between two Phase IV nodes. To understand the cause of these problems, you 
should understand how a Phase III node or link behaves within a network that sup- 
ports area routing. Phase III nodes do not know anything about areas. Therefore, 
when data to or from another area is routed through a Phase III node, the conse- 
quences can be unpredictable. 
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Whenever a Phase III node links with a Phase IV node in an area based network, the 
physical link is initialized with the Phase III protocol and all references to the area 
number of nodes are dropped. This affects the network in two ways: 

1 If the traffic is going from the Phase IV node with area routing to the Phase III 
node, the area designation is dropped. For example, if the address for node 5.167 is 
passed to a Phase III node, the address will become node 167 and the Phase III 
node will pass it on that way. 

2 If the traffic is coming from a Phase III node to a Phase IV node, the Phase IV 
node adds its own area number to the address of the destination node. For exam- 
ple, if the address for destination node 8.167 is passed to a Phase III node, the 
Phase III node drops the area designation, passing on the node address of 167 to 
the Phase IV node. If the address of the Phase IV node is 32.2, the node address of 
the destination node becomes 32.167. Of course, if the destination node is in the 
same area as the Phase IV node, the traffic would reach its proper destination. 

Referring to Figure 3-4, the following shows what may happen when a Phase III node 
is placed between two Phase IV nodes: If node SALES (node address 4.45) wants to 
communicate with node ACCNT (node address 4.88), data first goes to the Phase III 
node CHECK, which has a node address of 22 (no area number for Phase III nodes). 
Node CHECK drops the area number from the destination address of the data; that 
is, ACCNT's node address becomes 88. Then CHECK routes the data to ACCNT. 
ACCNT adds its own area number to the node address. The destination address 
becomes 4.88. Because the entire path is within the same area, no problem results. 

However, if node WAREH (node address 2.72) wants to send data to node SALES 
(4.45), the following happens: Because these two nodes are in different areas, 
WAREH sends the data to the nearest level 2 router in the destination area, which is 
node ACCNT. In turn, ACCNT routes the data to the Phase III node, CHECK, where 
all references to area addresses are dropped. CHECK sends the data to SALES with 
no problem. But, the problem arises when SALES tries sending a message back to 
WAREH: to send the message to WAREH, SALES must locate the nearest level 2 
router. SALES depends on node CHECK for information about level 2 routers. But, 
because CHECK is a PHASE III node, no such information is available. Therefore, 
SALES will not forward the message to CHECK. Eventually, node WAREH will 
timeout while waiting for a response from SALES. 

To avoid this problem, switch the locations of nodes SALES and CHECK so that 
CHECK is not between the two Phase IV nodes. 
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Figure 3-4: Improper Configuration of Phase III and Phase IV Nodes 
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Configuring the DECnet Router Server 



When you load the Communications Server hardware unit, DECnet Router Server 
initialization tasks read the network and router configuration files from the loading 
host. The tasks use the information contained in these files to set up the DECnet 
Router Server configuration. 

In Chapter 2, you defined parameters contained in these files. Ideally, the parameter 
values should match the needs of your configuration. If you define values that are too 
large or too small, you can waste server resources or inhibit server performance. After 
loading the server, you can change parameter values to fine tune your server and to 
reflect the changing needs of your configuration. To change parameter values in the 
configuration files, use any text editor on the host system. After you change values in 
the files, you must reload the server for the changes to take effect. This chapter 
describes parameters in each of the configuration files and explains how to edit them. 
This chapter also describes the parameters that you must define to set up your 
DECnet Router Server as a level 2 router for routing in a multiple area network. 
(Chapter 3 explains how to set up a multiple area network.) 

Both configuration files consist of commands whose format is similar to that of DEC- 
net network management commands. However, these commands are not network 
management commands. These commands are interpreted by the initialization tasks, 
not by network management. Sample files are shown in sections to follow and in 
Appendix B. 

NOTE 

After editing configuration files, make sure that the files have world 
read access. You are advised to protect your configuration files from 
being changed, deleted, or copied by unauthorized users. See Section 
5.5. 
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During installation, the files are created with the following names and stored on all 
potential loading hosts. Do not change these names. The files reside in the PLUTO 
account on these hosts. 



where 

server-node-id is the node name of the DECnet Router Server. 

Section 4.4 explains how the DECnet Router Server software handles errors found in 
the configuration files. 

4.1 Editing the Network Configuration File 

The network configuration file contains commands that set up the following parame- 
ters: 

• The UNA password 

• The network privileged password 

• The clock frequency for the DECnet Router Server node 

• A list of backup hosts 

The following subsections describe the commands and parameters contained in the 
network configuration file and how to change them. Example 4-1, located in Section 
4.1.5, shows a sample configuration file. The order in which commands appear in the 
file is arbitrary. 

4.1.1 Defining the UNA Password 

The UNA password prevents unauthorized users or nodes from reloading the server 
software. When the software is loaded, it reads this password from the network config- 
uration file on the loading host. Then it compares the UNA password with the service 
password specified with the NCP LOAD NODE or NCP TRIGGER NODE command, 
or if not specified, compares it with the default service password defined in the down- 
line load database on the loading host. If these passwords do not match, the load 
request is ignored. To define or change the UNA password, use the following com- 
mand in the network configuration file: 

SET LINE UNA-0 PASSWORD hex-password 



hex-password is the password, a hexadecimal number within the range of and 
FFFFFFFFFFFFFFFF (16-digit maximum). By default, no password 



If you do not specify a UNA password, or if the password you specify is invalid, then 
the default of will be set as the password for the DECnet Router Server and a service 
password will not be necessary for loading or triggering the server node. 



Network Configuration File: 
Router Configuration File: 



seruer-node-idSB. CFG 
seruer-node-idKTR.CFG 



where 



is set. 
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4.1.2 Defining the Network Privileged Password 

The network privileged password identifies the password used for access control verifi- 
cation at the server node. Users must specify this password when using privileged 
network management functions to access the server node. 

To define or change the password, use the following command: 

SET SYSTEM PASSWORD password 

where password contains up to eight alphanumeric characters. 

If you do not specify this password, or if the password you specify is invalid, then a 
null privileged password will be set for the server. Thus, no password will be necessary 
when using privileged network management functions. 

4.1.3 Specifying Backup Host Nodes 

Backup host nodes are nodes that the DECnet Router Server can use for recording 
event messages or receiving up-line crash dumps whenever its primary maintenance 
host is unavailable. You can specify a list of up to five backup hosts. 

Whenever the DECnet Router Server needs to use a backup host, it requests access to 
the first backup host specified in this list. If that host is not available, the server 
requests access to the next node in the list, and so on. 

If none of the backup hosts are available to receive an event message, the event 
message is not recorded. (You can set other nodes to receive event messages generated 
by the DECnet Router Server. See the DECnet Router Software Management Guide.) 

If none of the backup hosts are available to receive a crash dump, the DECnet Router 
Server then sends a request to the multicast address for the Ethernet. The first host to 
accept the dump will trigger a reload of the server. 

To specify the backup nodes, use the following command in the configuration file: 
SET EXECUTOR BACKUP HOSTS namel,name2,... named 

where 

namel,name2,...name5 are the names of up to five backup nodes. In a multiple area 
network, they should be in the same area as the server. Each node name must consist 
of one to six alphanumeric characters, with at least one character being alphabetic. 
List the names by priority, with namel being the first backup host that the server will 
try to access and name5 being the last. For the first backup host, choose the most 
reliable node (one that is usually up and running, not heavily loaded). All backup 
hosts should have adequate disk space for an up-line dump of server memory. 

The node names must be known to the DECnet Router Server. As explained in 
Section 3.1.1.2, the node names known to the server are those known to its host. 

The default for the backup host list is the server's host node, as identified in the 
down-line load database on the loading host. 

To display the list of backup hosts for a running server, use the NCP SHOW EXECU- 
TOR CHARACTERISTICS command shown in Appendix C and described in the 
DECnet Router Software Management Guide. 
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4.1.4 Setting the Clock Frequency 

The clock frequency parameter is used by the server's internal clock. The internal 
clock keeps track of time and is the source for the time recorded on event logging 
messages. If you specify the wrong clock frequency for your DECnet Router Server, 
then the time recorded in event messages will be wrong. 

The default clock frequency is 60 Hz and is used in the United States. You need not 
change the clock frequency unless the site of installation has a 50 Hz supply fre- 
quency. Installations in Europe, for example, require 50 Hz. To change the clock 
frequency from 60 to 50 Hz, use the following command: 

SET SYSTEM LINE FREQUENCY 50 

4.1.5 Sample Network Configuration File 

Example 4-1 shows a sample network configuration file used for DECnet Router 
Server node RTRDEV. 

NOTE 

The network configuration files generated by the VMSINSTAL and 
RSXINSTAL procedures do not include comments as does the exam- 
ple below. 



5 Network Configuration File - RTRDEV SB. CFG 

? 

5 1 ♦ Defining the UNA password (viewed by hosts as the service password)* 

5 Default if invalid or missing: NO PASSWORD SET 

SET LINE UNA-0 PASSWORD AAFFOO 

5 

5 2. Defining the Network Privileged password (system password)* 
5 Default if invalid or missing; NO PASSWORD SET 

SET SYSTEM PASSWORD COME 

5 

5 3. Setting the clock frequency to 5 H z ♦ 
5 Default if invalid or missing: SO Hz* 

SET SYSTEM LINE FREQUENCY SO 

5 

5 4* Backup host node list* 

5 Default: server's maintenance host 

SET EXECUTOR BACKUP HOSTS EAST* WEST* NORTH * SOUTH* CENTER 

Example 4-1: Sample Network Configuration File 
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4.2 Editing the Router Configuration File 



The DECnet Router Server uses the router configuration file to set up the routing 
parameter values for the network configuration. Section 4.2.1 describes the general 
procedure for defining and changing parameters in the router configuration file. Dur- 
ing installation when you specify the number of synchronous and asynchronous lines 
on your server, the installation procedure generates the appropriate software and 
router configuration file. A different configuration file is generated for each of the 
three possible software system configurations: 

• 8-line synchronous only 

• 8-synchronous/16-asynchronous 

• 16-synchronous/32-asynchronous 

You can use the configuration file as is, provided the defaults match your installation. 
Most likely you will need to tailor the file. (Appendix B includes sample unedited files 
for the 8-line synchronous only configuration and for the 8-/16-line configuration.) 
Section 4.3 lists the default values for the parameters defined in each router configu- 
ration file. 

Edit the file prior to loading the DECnet Router Server so that the routing configura- 
tion suits your network installation. 

NOTE 

Before editing the file, save a copy of the original file. You may need 
the original file for troubleshooting purposes. 

After loading the DECnet Router Server, you can edit the file to reconfigure or fine 
tune the server system. The changes do not take effect until you reload the server. 

You can also use NCP commands to change certain parameters while the server 
software is running. These changes take effect immediately and stay in effect until the 
server is reloaded. The parameters you can change in this way are shown in Table 4-1 
of Section 4.3. When reloaded, the default parameter values defined in the routing 
configuration file take effect. Appendix C lists the format for each NCP command 
available to you. See the DECnet Router Software Management Guide for details. 

4.2.1 Changing Routing Parameters 

The router configuration file uses the following commands to set parameters: 

SET CIRCUIT 
SET EXECUTOR 
SET LINE 

Use these commands to make permanent changes to parameter values. Reload the 
server after editing the file so that the values take effect. 
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One or more parameter keywords and their values follow each command; for example: 
SET EXECUTOR MAXIMUM ADDRESS 1022 

You can abbreviate commands and keywords to the first three characters. Do not 
abbreviate numerical parameter values. For example, abbreviate the preceding com- 
mand as follows: 

SET EXE MAX ADD 1022 

Include comments by preceding them with a semicolon (;). 

Except for the SET CIRCUIT and SET LINE commands, each command contains 
one parameter per line. The SET CIRCUIT and SET LINE commands may include 
several parameters per line, entered in any order. In addition, you can use a wildcard 
character (*) in SET CIRCUIT or SET LINE commands. The wildcard character 
allows you to set all circuits or lines to one value without specifying each circuit or line 
individually. This makes configuration files easier to edit. Also, if you want most of 
the circuits or lines to have the same value, but you want one or two to have different 
values, use the wildcard for a command to set the general value and then follow with 
additional commands for the components to be set differently. The following example 
shows how to set all circuits on the DECnet Router Server to the ON state, except 
circuit LC-4: 

SET CIRCUIT LC-* STATE ON HELLO TIMER 10 COST 5 
SET CIRCUIT LC-4 STATE OFF 

The LC mnemonic identifies the line card on the DECnet Router Server. The next 
section describes how to identify each of the server lines and circuits. Section 4.3.4 
includes more command examples. 

Once you load and start your DECnet Router Server, you can use NCP SHOW 
commands to display the current values for the routing parameters in the server's 
running database; for example: 

TELL server-node-id SHOW EXECUTOR 

See the DECnet Router Software Management Guide for more details of the NCP 
SHOW commands. 
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4.2.2 Identifying Server Lines and Circuits 



To identify the server's UNA circuit or line, specify UNA-0. To identify the point-to- 
point lines or circuits, specify the device name for line cards, LC, followed by a 
hyphen and the number of the slot that the line card occupies. As shown below, 
asynchronous lines require an additional specifier to distinguish the two lines on the 
card. The format for identifying lines or circuits is: 

LC-rc[L] 
[R] 

where 

LC Is the device name used for server line cards. 

n Is the unique number of the line card slot in the Ethernet Communications 
Server. 

L Identifies the line plugged into the left side of an asynchronous line card. Do not 
use to identify synchronous lines. 

R Identifies the line plugged into the right side of an asynchronous line card. Do 
not use to identify synchronous lines. 

Figure 4-1 shows a Communications Server with eight synchronous lines. The first 
eight line card slots are numbered in the figure. The slots are numbered left to right, 
from top to bottom, beginning with 1. Odd-numbered cards are on the left half of the 
Communications Server and even-numbered are on the right. As shown in the figure, 
identify the synchronous line connected to the card in slot 2 as LC-2. The figure also 
shows the numbering scheme for the maximum configuration of 16 synchronous lines. 

Figure 4-2 shows a Communications Server with 16 asynchronous lines. As shown, 
identify the two asynchronous lines connected to the card in slot 2 as LC-2L and 
LC-2R. The figure shows the numbering scheme for the maximum configuration of 32 
asynchronous lines. Remember that your server can have both synchronous and asyn- 
chronous line cards, as shown in Figure 1-3. 
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Figure 4-1: Numbering Scheme for Synchronous Lines 
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Figure 4-2: Numbering Scheme for Asynchronous Lines 
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4.3 DECnet Router Server Parameters 



The following sections describe the commands and parameters that define the routing 
configuration for the DECnet Router Server. Each subsection describes the com- 
mands and parameters applicable to one of the network components that make up the 
configuration: 

Executor node (the server) Section 4.3.1 
Circuit Section 4.3.2 

Line Section 4.3.3 

Table 4-1 lists the parameters that you can define or change for each component and 
their defaults. Parameters that you can change while the DECnet Router Server is 
running are preceded by an asterisk (*). Use the NCP SET commands shown in 
Appendix C and described in the DECnet Router Software Management Guide. Re- 
member that changes made to the running database stay in effect until the server is 
reloaded. To make the changes permanent, you must edit the configuration file. 

Parameters that you use to define the DECnet Router Server as a level 2 router in a 
multiple area network are preceded by an at sign (@). If you want your DECnet 
Router Server to be a level 2 router, assign the desired values to these parameters. 
Activate the command lines that include these parameters by removing the comment 
specifiers (";") that precede them. 

If you use the unedited router configuration file supplied with the distribution kit, the 
defaults listed in Table 4-1 are the values that will be used by the DECnet Router 
Server. Appendix B includes two unedited router configuration files, one for the 8-line 
synchronous only system configuration, and one for the 8-line synchronous/16-line 
asynchronous system configuration. 



4.3.1 Executor (Server) Node Parameters 

The following describes the parameters for the server node as the executor. 

4.3.1.1 BUFFER SIZE — This parameter specifies the size for buffers used by the 
DECnet Router Server for intermediate storage of user data being received and for- 
warded to adjacent nodes. This parameter also controls the maximum segment size of 
all messages received by the server node. The segment size, minus a 24-byte DECnet 
header, is the largest block of message data that can be transmitted over a physical 
line. (Note: This physical limitation does not restrict the size of user messages. If the 
message being transferred exceeds the segment size, DECnet divides the message into 
the necessary number of segments. The segments are transmitted to the destination 
node and the message is reconstructed.) 
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Table 4-1: Component Parameters 



Component Parameter Default 

EXECUTOR BUFFER SIZE 576 

MAXIMUM ADDRESS 255 

@ MAXIMUM AREA 63 

@ MAXIMUM AREA COST 1022 

@ MAXIMUM AREA HOPS 20 

MAXIMUM COST 1022 

MAXIMUM HOPS 20 
MAXIMUM BROADCAST NONROUTERS 32 

MAXIMUM BROADCAST ROUTERS 10 

* RECEIVE PASSWORD null 
SEGMENT BUFFER SIZE 576 

* TRANSMIT PASSWORD null 

CIRCUIT * COST 1 

HELLO TIMER 15 

ROUTING PRIORITY 100 

* STATE OFF 

LINE SPEED 9600 

DUPLEX FULL 

MODEM YES 



Section 4.3.4 includes sample router configuration files. 

The buffer size for the DECnet Router Server should be equal to the size used by other 
nodes in the network. If the buffer size for the server is smaller than that of another 
node that uses the server to forward messages to a destination node, the server may 
not forward the entire message. If the buffer size is larger than that of another node, 
buffer space will be wasted, and processes may have to wait for buffers to become 
available. 

WARNING 

All nodes in the network should have the same buffer size. 



) 
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Trade-offs: Consider the following when selecting the buffer size: 

1 The record-blocking factors (transmission segment size) used by application pro- 
grams. 

Most file transfer operations never send messages greater than 576 bytes. There- 
fore, a buffer size that exceeds this value would not be useful. If possible, select a 
buffer size (plus the DECnet header size of 24 bytes) that is an even multiple of 
the record size used by application programs. 

For example, when application programs block data into 256-byte records, a 
buffer size of 256 bytes is not appropriate. DECnet adds a 24-byte header to each 
segment, and thus must split each record into two segments to transmit it. One 
segment would have 232 bytes of data plus the 24-byte header, and the next 
segment would have only the remaining 24 bytes of the record data plus the 
header. This uses segments inefficiently and needs more memory for buffer space. 
It is better to increase the buffer size to 280 (256 plus 24) bytes, giving a larger 
segment size so that each record can be accommodated without splitting. You 
may or may not wish to have a larger buffer size, for the reasons indicated below. 

2 The error rate of the communication lines. 

If any lines are prone to errors, specify a smaller buffer size (256 bytes) to reduce 
the probability and cost of retransmissions over those lines. 

3 Your throughput requirements. 

High speed lines perform better with large buffers and large message segments 
because fewer messages must be processed. (This may not apply to lines that are 
error prone, as mentioned above.) 

A large buffer size is also good for bulk data transfers. Consider this if your server 
will be processing a high volume of network file transfers. However, note that a 
large buffer size reduces the number of buffers available. Consequently, with less 
buffers, processes may have to wait for buffers to become available. 

Format: To specify a buffer size, use the following command in the router configura- 
tion file: 

SET EXECUTOR BUFFER SIZE size 

where size is the buffer size in bytes, in the range 246 to 1484. The size value must be a 
multiple of four. If the value you specify is not a multiple of four, then the DECnet 
Router Server will automatically increase the buffer size to the next largest multiple 
of four. The server logs an event message informing you of this. The default buffer size 
is 576. 
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4.3.1.2 MAXIMUM ADDRESS — This parameter defines the largest node address 
(number) and, consequently, the greatest number of nodes that can be addressed by 
the DECnet Router Server in its own area. The value defines the size of the routing 
database. The range of possible values is 2 to 1023. All nodes in the network should 
have the same maximum address. 

Do not specify a maximum address less than the DECnet Router Server's node num- 
ber or the host node's number. Otherwise, the server automatically sets the maximum 
address to the default, which is 255, or to the larger of the two numbers if they are 
greater than 255. If the maximum address is less than the node number of any other 
nodes, those nodes will be excluded from the routing database. The server will not 
forward messages to those nodes. 

Trade-offs: Choose the lowest address possible that exceeds all other node addresses 
in the network. To ensure the smallest maximum address, node numbers should be 
assigned starting with 1 and incremented by 1. The higher the value you choose, the 
greater will be the routing overhead for the server's memory and central processing 
unit. The maximum number of nodes in the network depends on the number of 
broadcasting routers specified in the router configuration file. The values for these are 
limited by DNA restrictions and by the size restrictions for the DECnet Router 
Server's routing database. The following formula defines the limits for these entities: 

(Max Addr) * ((3.5 + no. of lines) + no. broadcast routers) < 24500 

The number of lines can be either 8, 16, or 32, depending on which system image is 
used. A broadcast router is a routing node on the same Ethernet as the server. The 
formula above assumes the maximum configuration for a maximum node address of 
1023, 9 active lines, and 12 broadcast routers. Once your network reaches the maxi- 
mum configuration, if you increase the number of nodes in the network, you must 
decrease the number of broadcast routers. Likewise, if you decrease the number of 
nodes, you can increase the number of broadcast routers. 

Format: To set the maximum address, use the following command in the router 
configuration file: 

SET EXECUTOR MAXIMUM ADDRESS address 
where address is in the range of 2 to 1023. 

4.3.1 .3 MAXIMUM AREA — If you want your DECnet Router Server to be a level 2 
router in a multiple area network, use this parameter to limit the number of areas 
that the server will recognize. The range of possible values is 2 to 63. All level 2 routers 
in the network should have the same maximum. 

Do not specify a maximum area value less than the DECnet Router Server's area 
number or the host node's area number. Otherwise, the server automatically sets the 
maximum area to the default, which is 63. 
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By default, the DECnet Router Server is set for level 1 routing only. The command 
line in the configuration file that defines the maximum area parameter is preceded by 
a semicolon (;), which makes the line a comment instead of a command to be pro- 
cessed. To set up the DECnet Router Server as a level 2 router, delete the semicolon. 
If necessary, change the value of the maximum address parameter to suit your net- 
work. (The predefined value is 63.) 

Trade-offs: Choose the lowest area number possible that exceeds all other area num- 
bers in the network. To ensure the smallest maximum area, area numbers should be 
assigned starting with 1 and incremented by 1. The higher the value you choose, the 
greater will be the routing overhead for the server's memory and central processing 
unit. 

Format: To set the maximum area, use the following command in the router configu- 
ration file: 

SET EXECUTOR MAXIMUM AREA number 
where number is in the range of 1 to 63. 

Remember to delete the semicolon that precedes the command line in the configura- 
tion file provided with the distribution kit. If you do not want your DECnet Router 
Server to be a level 2 router, this command should be preceded by the semicolon. (The 
server initialization task will see the command as a comment and will not process the 
command ) Do not delete the command, You may decide to use your DECnet Router 
Server as a level 2 router at a later time. 

4.3.1.4 MAXIMUM AREA COST — If you want your DECnet Router Server to be a 
level 2 router in a multiple area network, use this parameter to control the total path 
cost between the server and any other area in the whole network. The total path cost 
between areas is the sum of the routing path costs along a path between level 2 
routers. The DECnet Router Server uses the maximum area cost parameter to find 
out if an area in the network is reachable. An area is unreachable if the cost to get to 
the closest level 2 router in that area exceeds the value of this parameter. 

Select a maximum path cost that is large enough to include all the areas that you 
want to be reachable. 

By default, the DECnet Router Server is set up as a level 1 router. In the configura- 
tion file supplied with your distribution kit, the command line defining the maximum 
cost parameter is preceded by a semicolon. When the configuration file is processed, 
the server initialization task will treat this line as a comment. If you wish to set up 
your DECnet Router Server as a level 2 router, remove the semicolon. Also, if neces- 
sary, change the value of the maximum cost parameter to suit your network. The 
default is 1022. 
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Trade-offs: This parameter serves to limit the size of the reachable network. If you 
set a high value, the DECnet Router Server can reach more areas. If you have an 
extremely large network that includes areas with which communications will be infre- 
quent and unnecessary, use this parameter to exclude these areas from the DECnet 
Router Server's reachable network. That is, set the parameter to a value that is less 
than the total path cost required to reach any of the level 2 routers in those areas. 
There is no drawback if you choose all areas to be reachable. 

Format: To set the maximum area cost, use the following command in the router 
configuration file: 

SET EXECUTOR MAXIMUM AREA COST cost 

where cost is in the range of 2 to 1022. The default is 1022. Remember to delete the 
semicolon that precedes the command line in the configuration file provided with the 
distribution kit. If you do not want your DECnet Router Server to be a level 2 router, 
do not delete the semicolon. Do not delete the command. You may decide to use your 
DECnet Router Server as a level 2 router at a later time. 

4.3.1 .5 MAXIMUM AREA HOPS — If you want your server to be a level 2 router in a 
multiple area network, use this parameter to set the maximum number of hops that a 
message can make between the DECnet Router Server and any other area in the 
whole network. A hop is the logical distance over a line between two adjacent nodes. 
The DECnet Router Server uses this parameter to find out if an area in the network is 
reachable. An area is unreachable if the number of hops needed to get to the closest 
level 2 router in that area exceeds the value of this parameter. 

The value of this parameter should always be large enough to include all the areas 
that you want to be reachable. 

By default, the DECnet Router Server is set up as a level 1 router. In the configura- 
tion file supplied with your distribution kit, the command line defining the maximum 
hops parameter is preceded by a semicolon. When the configuration file is processed, 
the server initialization task will treat this line as a comment. If you wish to set up 
your DECnet Router Server as a level 2 router, remove the semicolon. Also, if neces- 
sary, change the value of the maximum hops parameter to suit your network. The 
default is 20. 

Trade-offs: This parameter serves to limit the size of the reachable network. If you 
set a high value, the DECnet Router Server can reach more areas. If you have an 
extremely large network that includes areas with which communications will be infre- 
quent and unnecessary, use this parameter to exclude these areas from the DECnet 
Router Server's reachable network. That is, set the parameter to a value that is less 
than the total number of hops required to reach any of the level 2 routers in those 
areas. There is no drawback if you choose all level 2 routers to be reachable. 
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Format: To set the maximum number of area hops, use the following command in the 
router configuration file: 

SET EXECUTOR MAXIMUM AREA HOPS hops 

where hops is in the range of 2 to 30. The default is 20. Remember to delete the 
semicolon that precedes the command line in the configuration file provided with the 
distribution kit. If you do not want your DECnet Router Server to be a level 2 router, 
do not delete the semicolon. Do not delete the command. You may decide to use your 
server as a level 2 router at a later time. 

4.3.1.6 MAXIMUM BROADCAST NONROUTERS — This parameter specifies the 
maximum number of Ethernet nonrouting nodes (end nodes) that the server's running 
database can contain at any one time. This applies only to nonrouting nodes on the 
same Ethernet as the server. Set this parameter large enough to include all nonrout- 
ing nodes on the Ethernet. 

Trade-offs: The larger the number, the greater the overhead for the server's central 
processing unit. However, if the number is too small, some nonrouting nodes may be 
unreachable (directly) due to limits on the size of the server's routing database. They 
will be reachable through another routing node that includes the nonrouting node in 
its database. 

Format: To set the maximum number of nonrouting nodes, use the following com- 
mand in the router configuration file: 

SET EXECUTOR MAXIMUM BROADCAST NONROUTERS number 

where number is in the range of to 1022. The default value is 32. 

The number must be less than the maximum node address minus one. If the number 
of broadcast nonrouting nodes is greater than the maximum node address minus one, 
the DECnet Router Server automatically sets the maximum of nonrouters to the 
maximum node address minus one. For example, if you set the maximum number of 
nonrouters to 1022, and the maximum node address is 255, then the DECnet Router 
Server sets the maximum number of nonrouters to 254. The server sends the following 
message to the event-logging facility on its host: 

WARNING: MAXIMUM BROADCAST NONROUTERS set to MAXIMUM ADDRESS minus one. 



4.3.1.7 MAXIMUM BROADCAST ROUTERS — This specifies the maximum num- 
ber of other Ethernet routing nodes that the DECnet Router Server's running data- 
base can contain at any one time. This applies to routing nodes on the same Ethernet 
as the server. Set this parameter large enough to include all other routing nodes on the 
Ethernet. 
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Trade-offs: The larger the number, the greater the overhead on the server's central 
processing unit. If the number is too small, some routing nodes may be unreachable 
due to limits on the size of the server's routing database. If you specify a value that is 
less than the actual number of routers on the Ethernet, then your DECnet Router 
Server can reach only that many routers in one hop. For example, if your Ethernet has 
15 routing nodes and you specify five, then your router will be able to reach in one hop 
those five routers only. The excluded routing nodes, although directly unreachable, 
will be reachable through other routing nodes on the Ethernet. 

When the number of active routing nodes reaches the limit, router nodes with the 
lowest routing priority are dropped from the routing database. Section 4.3.2.3 
discusses the routing priority parameter. 

Format: To set the maximum number of routing nodes, use the following command in 
the router configuration file: 

SET EXECUTOR MAXIMUM BROADCAST ROUTERS number 
where number is in the range of 1 to 33. The default is 10. 

4.3.1.8 MAXIMUM COST — The DECnet Router Server uses this parameter to find 
out whether a destination node in the network is reachable. The parameter specifies 
the maximum total path cost allowed from the server node to any other node. A 
remote node is unreachable if the cost to get to the remote node exceeds the value of 
this parameter. The path cost is the sum of the routing circuit costs along a path 
between two nodes. Section 4.3.2.1 explains how to specify the routing cost for each 
circuit on the server node. Select a maximum total path cost that is large enough to 
include all the nodes that you want to be reachable. 

Trade-offs: This parameter serves to limit the size of the reachable network. If you 
set a high value, the DECnet Router Server can reach more nodes. If you have an 
extremely large network that includes distant nodes with which communications will 
be infrequent and unnecessary, use this parameter to exclude these nodes from the 
DECnet Router Server's reachable network. (However, there is no drawback if you 
choose all nodes to be reachable.) 

Format: To set the maximum cost, use the following command in the router configu- 
ration file: 

SET EXECUTOR MAXIMUM COST cost 

where cost is in the range of 2 to 1022. The default is 1022. 
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4.3.1.9 MAXIMUM HOPS — The DECnet Router Server uses this parameter to find 
out whether a destination node is reachable. The parameter specifies the maximum 
number of routing hops from the server node to any other reachable node. A remote 
node is unreachable if the number of hops required to get to it exceeds the value set 
for this parameter. A hop is the logical distance over a line between two adjacent 
nodes. The value of the maximum hops parameter should always be equal to or 
greater than the longest possible path within the network. The range of valid values is 
from 2 to 30. The default is 20. 

Trade-offs: This parameter limits the size of the reachable network. If you set a high 
value, the DECnet Router Server can reach more nodes. If you have an extremely 
large network that includes distant nodes with which communications will be infre- 
quent and unnecessary, use this parameter to exclude these nodes from the DECnet 
Router Server's reachable network. (However, there is no drawback if you choose all 
nodes to be reachable.) 

Format: To set the maximum hops, use the following command in the router configu- 
ration file: 

SET EXECUTOR MAXIMUM HOPS hops 

where hops is in the range of 2 and 30. The default is 20. 

4.3.1.10 RECEIVE PASSWORD — This parameter specifies a password that the 
DECnet Router Server uses to control access from adjacent nodes not on the Ethernet. 
The circuit connecting an adjacent node does not come up unless the password sup- 
plied by the adjacent node matches the DECnet Router Server's receive password. 

In multiple area networks, this parameter is significant for circuits connecting adja- 
cent DECnet Phase III nodes. Phase III nodes in a multiple area network must have a 
transmit password. This helps you locate Phase III to Phase IV connections across 
area boundaries. Such connections should be prevented, as explained in Section 3.3. 

If you do not define a receive password, then adjacent nodes can access the DECnet 
Router Server without supplying a password. 

You can change the receive password in the running database of the DECnet Router 
Server by using the NCP SET EXECUTOR command, as shown in Appendix C. 

Trade-offs: If you specify a receive password, you can prevent unauthorized access 
from remote adjacent nodes. 

Format: To set the receive password, use the following command in the router config- 
uration file: 

SET EXECUTOR RECEIVE PASSWORD password 

where password is a string of up to 8 ASCII characters. In the configuration file 
provided with the distribution kit, the command line is preceded by a semicolon so 
that no password will be set. To define a password, delete the semicolon. 
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4.3.1.11 SEGMENT BUFFER SIZE — This parameter specifies the size of buffers 
used to communicate with the DECnet Router Server. This parameter determines the 
maximum message size that the DECnet Router Server can receive or send. This 
parameter deals with network management communications to the DECnet Router 
Server. It has nothing to do with routed messages. 

Trade-offs: This parameter should be less than or equal to the buffer size parameter. 
When you are changing the buffer size throughout the network, make sure the seg- 
ment buffer remains less than or equal to the buffer size. To increase the network 
buffer size, first increase the buffer size throughout the network, then the segment 
buffer size. To decrease the network buffer size, first decrease the segment buffer size 
throughout the network, then the buffer size. For more information, refer to the 
appropriate host system DECnet documentation. If you are not changing the buffer 
size throughout the network, then this should be equal to the buffer size. 

If the segment buffers of the server node and a destination or source node differ in 
size, then the server uses the smaller of the segment buffer sizes for sending or 
receiving the data. 

Format: To set the segment buffer size, use the following command in the router 
configuration file: 

SET EXECUTOR SEGMENT BUFFER SIZE size 

where size is in the range of 246 to 1484 bytes. The default is 576. 

4.3.1.12 TRANSMIT PASSWORD — This parameter specifies a password that the 
DECnet Router Server can supply to allow it to communicate with an adjacent non- 
Ethernet node. The transmit password must match the adjacent node's receive pass- 
word. If the passwords match, then the circuit connecting the server and the adjacent 
node will come up. If the passwords do not match, the circuit will not come up. 

If none of the adjacent nodes have set up a receive password, then you need not 
specify a transmit password for the server. 

You can change the transmit password in the running database of the server by using 
the NCP SET EXECUTOR command, as shown in Appendix C. 

Trade-offs: Specify a transmit password if any adjacent non-Ethernet node requires 
it; otherwise, the server will not be able to access that node. 

Format: To set the transmit password, use the following command in the router 
configuration file: 

SET EXECUTOR TRANSMIT PASSWORD password 

where password is a string of up to 8 ASCII characters. In the configuration file 
provided with the distribution kit, the command line is preceded by a semicolon so 
that no password will be set. To define a password, delete the semicolon. 

) 
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4.3.2 Circuit Parameters 



Commands for setting circuit parameters can contain more than one parameter per 
line, in any order. Section 4.2.1 discusses how to change circuit parameters and how to 
use wildcard characters (*) for setting the same parameter for more than one circuit. 
Section 4.2.2 explains how to identify circuits on the server. 

The router configuration file includes commands for the maximum number of circuits 
(synchronous and asynchronous) supported by your server's software image. By de- 
fault, only the commands for synchronous lines are activated. Commands for asyn- 
chronous lines are preceded by a semicolon so that the server initialization task will 
treat these lines as comments. If your server has asynchronous lines, enable the 
commands defining parameters for the asynchronous lines by deleting the semicolon 
preceding each of the appropriate commands, and if necessary, change the parameter 
values to suit your configuration. Insert semicolons before the commands for the 
unused synchronous lines. For example, if the line in slot 1 is asynchronous, delete the 
semicolon preceding the lines defining LC-1L and LC-1R, and insert a semicolon 
before the line defining LC-1 (the synchronous line). 

Insert semicolons before any other commands that define lines not used on your 
server. 

Table 4-2 shows the line configurations supported by the server. 
Table 4-2: Line Configurations 



Line Speed Number of lines Aggregate Bandwidth 

19.2 Kbps 32 sync/async 307.2 Kbps per PAM 

19.2 Kbps 16 sync/async 307.2 Kbps 

56 Kbps 8 sync 448 Kbps 

250 Kbps 2 sync 500 Kbps 

i 

500 Kbps 1 sync 500 Kbps 

The total bandwidth must not exceed 500Kbps; otherwise, the DECnet Router Server 
automatically turns all circuits off. 

4.3.2.1 COST — This parameter specifies the routing cost of the circuit. The DEC- 
net Router Server uses the cost value of each circuit to determine which path it will 
use to route data to the destination node. The DECnet Router Server calculates the 
path cost for each path to the destination node and chooses the least costly path. The 
path cost is the sum of the costs of the circuits that make up the path. Messages will 
travel between nodes along the path with the smallest total cost. 

You can change the cost of a circuit in the running database of the DECnet Router 
Server by using the NCP SET CIRCUIT command, as shown in Appendix C. 
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Trade-offs: The DECnet Router Server is less likely to route messages along a high 
cost circuit than a low cost circuit. Therefore, give high speed lines lower cost values 
and low speed lines higher cost values. In this way, you can force more messages along 
the high speed lines and thus improve network traffic flow. 

Format: To set the cost of a circuit, use the following command in the router configu- 
ration file: 

SET CIRCUIT dev COST cost 

where dev is the identity of a UNA or LC circuit, and cost is a decimal integer in the 
range 1 to 25. The default value is 1. 

4.3.2.2 HELLO TIMER — This parameter specifies how often the server sends hello 
messages to the adjacent node on the specified point-to-point circuit. If the adjacent 
node does not receive a hello message from the server within a specified time, it 
considers the server as unreachable. The length of time that can elapse before this 
happens depends on the value of the listen timer on that node. 

The listen timers on all Phase III nodes have the same fixed value. Therefore, if the 
adjacent node is a Phase III node, set the hello timer to 5 seconds. Phase IV nodes 
calculate the listen timer from the adjacent node's hello timer. 

Trade-offs: If the timer is set too large, then the adjacent node will wait a long time 
before it detects that the server is not reachable. 

Format: To set the hello timer, use the following command in the router configuration 
file: 

SET CIRCUIT dev HELLO TIMER seconds 

where dev is the identity of a UNA or LC circuit and seconds is a decimal integer in 
the range 3 to 8191. The default value is 15. 

4.3.2.3 ROUTING PRIORITY — This parameter applies only to Ethernet (UNA) 
circuits and specifies the priority this DECnet Router Server will have in the selection 
of a designated router for this circuit. (Section 3.2 describes the function of designated 
routers.) 

Trade-offs: If there are two or more routers on the same Ethernet, the designated 
router provides message routing services for end nodes on the Ethernet. If you specify 
a high priority for your DECnet Router Server, it is more likely to be chosen as the 
designated router. If any of the other routers on the Ethernet is a DECnet 
Router/X.25 Gateway, it is better to give your DECnet Router Server a higher priority 
and thus increase its workload, leaving the combined Router/Gateway free for other 
processing. 
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Also, if another router on the Ethernet has connections to a larger network than does 
your DECnet Router Server, then specify a lower priority for your router than for the 
other router. In this way, the other router is more likely to be selected as the desig- 
nated router. Then, other nodes on the Ethernet can route messages destined for the 
larger network directly to the router connected to that network, instead of wasting an 
unnecessary hop to your DECnet Router Server (the messages will go to the desig- 
nated router anyway). This will improve the throughput of your network. 

Format: To set the router priority for the UNA circuit on your server, use the follow- 
ing command in the router configuration file: 

SET CIRCUIT UNA-0 ROUTER PRIORITY number 

where number is in the range of to 127. The default is 100. 

4.3.2.4 STATE — This parameter specifies the circuit's operational state. There are 
two possible states applicable to DECnet Router Server circuits. 

OFF The circuit is not in use. 

ON The circuit is available for normal use or service functions. 

You can change the state of a circuit while the DECnet Router Server is running. Use 
the NCP SET CIRCUIT command, as shown in Appendix C. This change stays in 
effect until the next time you reload the server. When you reload the server, the state 
of the circuit will be as defined in the router configuration file. 

Format: To set the state of a circuit, use the following command in the router configu- 
ration file: 

SET CIRCUIT LC-n STATE circuit-state 

where n is the number of the circuit and circuit-state is OFF or ON. For asynchronous 
circuits, specify L or R for the position on the line card; for example, LC-3L. The 
default operational state is OFF. 

4.3.3 Line Parameters 

As with circuits, commands setting line parameters can include more than one pa- 
rameter per line, in any order. Section 4.2.1 discusses how to define line and circuit 
parameters, and how to use wildcards (*) for defining the same parameter for all lines. 

Line parameters are: DUPLEX, MODEM, and SPEED. These parameters apply to 
LC lines only. The settings for these parameters must be consistent with the settings 
for the adjacent node connected by the line being defined. 

You cannot change these parameters dynamically with NCP. If hardware changes are 
made that affect these parameters, you must change the parameters and reload the 
server node. 
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4.3.3.1 DUPLEX — This parameter specifies the hardware duplex mode of the line. 
There are two possible modes: 



FULL full duplex (default) 
HALF half duplex 

The duplex must be the same as defined on the adjacent node at the other end of the 
line. 

Format: To set the duplex parameter for a line, use the following command in the 
router configuration file: 



where n is the number of the circuit. For asynchronous circuits, specify L or R for the 
position on the line card; for example, LC-3L. 

4.3.3.2 MODEM — This parameter specifies whether the line is connected by an 
external modem. (Null modems or null modem cables are considered as a modem.) 
Modems are required for all high speed lines (M3101), for all leased lines, and for any 
low speed lines connected to devices other than LCs (such as DMCs or DMRs). 
Specify MODEM YES for such lines. Specify MODEM NO only for low speed lines 
(M3100) connecting your server to a line card on another local server, such as a line 
that connects your server to another DECnet Router Server, forming a connection 
between two Ethernets. If you have such a configuration, make sure the router config- 
uration files for both servers have the corresponding lines set up in the same way. 



For interconnection of two Ethernets requiring heavy traffic, use high 
speed lines (M3101). 

Some modems have dual rates. The DECnet Router Server forces the modem to work 
at the highest of the two rates. 

Trade-offs: If this parameter is set wrong, the line will not work. 
Format: SET LINE LC-n MODEM JyEsI 



where n is the line number. For asynchronous circuits, specify L or R for the position 
on the line card; for example, LC-3L. Specify YES if the line has a modem, and 
specify NO if the line does not have a modem. The default is MODEM YES. 



SET LINE LC-n DUPLEX 




NOTE 
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4.3.3.3 SPEED — This parameter specifies the receive and transmit speed for the 
line. If you specify an invalid line speed, the DECnet Router Server uses the next 
greater valid speed. The maximum line speed for DCSAX-LA (M3100) line cards is 
19,200 bits per second. The maximum for DCSAX-LB (M3101) line cards is 500,000 
bits per second. For M3101 line cards, the speed you choose is determined by the 
clocking speed of the modems on the line. The default speed for both types of line 
cards is 9600. 

Remember that the sum of the speeds for all the LC lines on your server must be less 
than 500,000 bps. 

Format: To set the speed of an LC line, use the following command in the router 
configuration file: 

SET LINE LC-n SPEED speed 

where speed is an integer greater than zero. Observe the maximum speeds allowed for 
each line card type. For asynchronous circuits, specify L or R for the position on the 
line card; for example, LC-3L. 

4.3.4 Sample Router Configuration Files 

Sections 4.3.4.1 and 4.3.4.2 each contain an example of a customized router configura- 
tion file. Section 4.3.4.1 contains a customized router configuration file for a DECnet 
Router Server in a single area network and having four synchronous lines (the soft- 
ware supports a maximum of eight synchronous lines). Section 4.3.4.2 contains a 
customized file for a DECnet Router Server with both synchronous and asynchronous 
lines. The server is set up as a level 2 router in a multiple area network. Appendix B 
includes two unedited router configuration files which show how the customized 
router configuration files (Examples 4-2 and 4-3) appear before editing. 

4.3.4.1 Sample Customized File for Server with Four Lines — The following file 
is set up for the DECnet Router Server RTRDEV, with four synchronous lines. Figure 
4-3 shows the physical network configuration for RTRDEV. Example 4-2 contains the 
router configuration file. There are 40 end nodes and 14 routing nodes or DECnet 
Router Servers on RTRDEV s Ethernet (LAN1). 

The greatest number of nodes in the area that RTRDEV can address is 500, the value 
set to the maximum address parameter in the configuration file. All the nodes shown 
in Figure 4-3 have a buffer size of 800 bytes. Thus, the buffer size parameter in the file 
is set to 800 bytes. The file limits the reachable network for the DECnet Router Server 
to all nodes at a distance of 10 hops or less (maximum hops parameter). 

Line LC-1 links two DECnet Router Servers and is a high speed line. Therefore, it 
needs a modem. Lines LC-2, LC-3, and LC-4 need modems because they connect to 
devices other than LCs. In this configuration, the traffic on LC-1 should not be heavy. 
Therefore, RTRDEV can handle other lines. LC-1 is a high speed line (56,000 bps). 
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Figure 4-3: Configuration for Sample Customized Routing Configuration File 



The cost on LC-3 is set at a higher value than the cost of LC-1 so that the high speed 
line will be used more often for communications to LAN2. Notice messages can take 
either of two paths from RTRDEV to the Phase III network: one through LC-3 and 
the other through LC-1 to the line connecting LAN2 and the Phase III network. 

Note that the SET CIRCUIT commands have been edited so that the circuits are 
turned to the ON state. 

The routing priority for RTRDEV is higher than the default (110 instead of 100). This 
helps ensure that RTRDEV will be the designated router for LANl. Also, the hello 
timer for UNA-0 is set to a higher value than the default (25 instead of 15). Thus, 
fewer hello messages will be sent; this minimizes message traffic over the UNA. 
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Both the transmit and receive passwords for all adjacent nodes connected by LC lines 
are ETHER. Thus, the transmit and receive passwords for RTRDEV are defined as 
ETHER. To enable the command lines defining these passwords, the semicolons 
preceding the lines have been deleted. 

Notice that semicolons precede the lines defining area parameters (lines 13, 14, and 
15). This sets up RTRDEV as a level 1 router. 
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6. Set the BUFFER SIZE for the DECnet Router Server, These 

buffers are used for the intermediate storage of all user 
data being transmitted or received* Legal range for the 
BUFFER SIZE parameter is 246 to 1484 inclusive. The 
default value for this parameter is 576, 
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SET EXECUTOR BUFFER SIZE 800 

Set the SEGMENT BUFFER SIZE. This parameter allows nodes 
with different buffer sizes to communicate efficiently. 
The ledal rantfe for the SEGMENT BUFFER SIZE parameter is 
24G to 1484 inclusive. The default value for this 
parameter is 57G. 
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The duplex parameter for the line can be DUPLEX FULL or 
DUPLEX HALF. 



The modem control parameter can be MODEM YES or MODEM NO. 



The default values for these parameters are SPEED 9 G » 
DUPLEX FULL and MODEM YES, The leSal devices are LC-1 
through LC-8. 
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1320 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


3 


SPEED 


S G 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


a 


SPEED 


SGOO 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


5 


SPEED 


9G00 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


G 


SPEED 


SGOO 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


7 


SPEED 


S G 


DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


8 


SPEED 


9 6 


DUPLEX 


FULL 


MODEM 


YES 



(continued on next page) 



Example 4-2 (cont.): Router Configuration File for Server with Four Synchronous Lines 



5 9. Set the circuit characteristics (COST> HELLO TIMER > STATE) 

? for the point-to-point circuits from the DEC net Router 

5 Server . The legal range for the cost parameter is 1 to 25 

? i n c 1 u s i u e . This sets the path cost between the D E C n e t 

? Router and the adjacent node on the circuit* The legal 

5 range for the HELLO TIMER parameter is 3 to 8191. The 

5 HELLO TIMER is the rate in seconds that idle transport 

5 messages are sent to maintain reachability* The options for 

5 the state parameter are STATE ON or STATE OFF* The default 

i ual ues for COST t HELLO TIMER and STATE are It 15 seconds 



an 


d off r 


e s pe 


ctiueh 














SET 


CIRCUIT 


LC- 


* 


COST 


1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


1 


COST 


1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 




COST 


5 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


3 


COST 


a 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


a 


COST 


3 


HELLO 


TIMER 


15 


STATE 


ON 



10. Set the circuit UNA-0 parameters (COST> ROUTING PRIORITY* 
HELLO TIMER) . The COST and HELLO TIMER parameters haue the 
same attributes and defaults as described a b o u e for L C 
circuits. The ROUTING PRIORITY parameter designates which 
router will serve the Ethernet. If two routing nodes haue 
the s a m e priority t then the node with the higher node 
address will be the designated router for the Ethernet. 
The legal range for the ROUTING PRIORITY parameter is to 
127 i n c 1 u s i m e . The default for this parameter is 100. 

SET CIRCUIT UNA-0 COST 1 ROUTING PRIORITY 110 HELLO TIMER 25 

11, Set the TRANSMIT PASSWORD t which the executor node must 
transmit to an adjacent node during a node initialization 
sequence. The password is one to eight ASCII characters. 
The default for this parameter is no password. 



(continued on next page) 

Example 4-2 (cont.): Router Configuration File for Server with Four Synchronous Lines 



SET EXECUTOR TRANSMIT PASSWORD ETHER 



12, Set the RECEIVE PASSWORD > w 


h 


ich the execu 


t 


or node 




e x p e 


to receive from an adjacent 




n ode d u rind a 




n ode 






initialization sequence* T h 


e 


password is 





n e to e 


i 


3h t 


ASCII characters. The defau 


1 


t for this pa 


r 


a m e t e r 


i 


s n o 


password. 














SET EXECUTOR RECEIVE PASSWORD 




ETHER 










13. Set the MAXIMUM AREA number 




in the DECnet 




n e t w o r k 




The 


ledal rande for this parame 


t 


e r is 2 to G3 




i n c 1 u s i 


v 


e . I 


this parameter is specified 


> 


the DECnet R 





titer w i 


1 


1 be 


an area router. The default 




u a 1 u e for the 




MAXIMUM 




AREA 


parameter is level 1 r o u t i n 




only. Refer 


t 


o the 






doc u m e n t a t i o n w hen confix u r 


i 


rid areas. 










SET EXECUTOR MAXIMUM AREA G3 















14. Set the to 


t 


al 


n u m b e 


r 


of 


a r 


e a 


h 


OPS 




f 


rom t 


he DECn 


e 


t Rout 


e 


r 


Server's a 


r 


e a 


to an 




o t h 


e r 


r e 


a 


c h a 


b 


1 


e are 


a in t h 


e 


n e t w o 


r 


k . 


A remote a 


r 


e a 


i s u n 


r e 


a c h 


ab 


1 e 





v e r 




a 


path 


if the 




n u m be r 




of 


hops resui 


r 


e d 


to si e 


t 


t 


i t 


e x 


c 


e e d 


5 




the v 


a 1 u e s e 


t 


for t 


h 


i s 


parameter. 




Th 


e 1 e da 


1 


ran 


de 


f 


r 


th 


e 




AREA 


HOPS pa 


r 


a m e t e r 




i s 


2 to 30 in 


c 


1 u 


s i v e . 


If 


th 


i s 


pa 


r 


am e 


t 


e 


r is 


s p e c i f i 


e 


d t the 






DECnet Ron 


t 


e r 


will 


b e c o m 


e 


an 


a 


r e a 




r 


outer 


. The d 


e 


fault 






value for 


t 


he 


AREA 


HOPS 


p a 


r am 


e 


t e r 




i 


s lev 


el 1 r o 


u 


t i n a o 


n 


1 Y 


Refer to t 


h 


e 


doc u m e 


n t a t i 


o n 


w h 


e 


n c 





n 


f i £f u r 


ina are 


a 


5 ♦ 







i SET EXECUTOR MAXIMUM AREA HOPS 20 

(continued on next page) 

Example 4-2 (cont.): Router Configuration File for Server with Four Synchronous Lines 



t 

CO 



15. Set the total cost from the DEC net Router Server's area to 
anv other reachable area in the network. A remote area is 
unreachable over a path if the cost required to Set to it 
exceeds the ualue set for this parameter* The legal range 
for the AREA COST parameter is 2 to 1022 inclusive. If 
this parameter is specified* the DEC net Router i A i i 1 1 become 
an area router. The default value for this parameter is 
level 1 routing only. Refer to the documentation w h e n 
configuring areas. 



SET EXECUTOR MAXIMUM AREA COST 1022 



Example 4-2 (cont.): Router Configuration File for Server with Four Synchronous Lines 



o 
m 
O 

3 
CD 

U 

o 
c 

#— h 

CD 
— ^ 

to 
O 

— h 

CD 

5" 

CO 

<■+ 

6 

O 
c 

Cl 
CD 



4.3.4.2 Sample Customized File for Server with Synchronous and 
Asynchronous Lines — The next sample configuration file, shown in Example 4-3, 
is for DECnet Router Server RTRD2, a level 2 router with six synchronous lines and 
four asynchronous lines. This file, too, has been edited. The original file copied from 
the distribution kit during installation comes with the DECnet Router Server system 
image supporting up to eight synchronous or 16 asynchronous lines. Appendix B 
includes a sample of the unedited file for such software configurations. 

In Example 4-3, commands for unused lines are preceded by a semicolon. In the 
original file, all commands defining parameters for asynchronous lines were preceded 
by a semicolon. Because RTRD2 has four asynchronous lines, LC-7L through LC-8R, 
you have to enable the commands for these lines by deleting the semicolons preceding 
them. Also, you have to insert semicolons before the commands defining parameters 
for synchronous lines LC-7 and LC-8. 

To set up the DECnet Router Server as a level 2 router, the area routing commands 
(13, 14, and 15 in the sample file) are enabled. 

Notice that the SET CIRCUIT command lines have been edited so that the circuits 
are turned to the ON state. Except for using asynchronous lines and area routing, 
RTRD2 uses all the defaults. No receive or transmit passwords are set. 



Configuring the DECnet Router Server 



4-33 



D E C ri e t Router Server 


In 


i 


t i 


al 


i z a t i o n 




File 








Copyright (c) 1984 by 






















Digital Equipment Cor 


P 


r 


at 


i o 


n t Ham 


a 


r d > Mass* 








File name = "Server's 


n 





de 


n 


ame "RTR 


♦ 


CFG 








This configuration f i 


1 e 




r e 


s i 


d e s o n 


t 


he PLUTO / PLUTO 


ac c o 


u n t o 


r 


General D E C n e t accoun 


t 





f 


th 


e do w n - 


1 


i n e loading ho 


st s y 


stem. 


Th i s 


file uses all the def 


a u 


1 


t 


v a 


lues f o 


r 


configuring a 


DECn 


e t Ro 


liter 


Server node. Note all 


M 


a 


1 u 


e s 


are in 




decimal * 









1 , 


Set t 


he 


MAXIMUM ADDRESS in the DECnet 


n e 


t 


w o r k . 


The 




r a n g e 


f 


or this parameter is 2 to 1023 


i n 


c 


1 u s i v 


e , Th 




d e f a u 


1 1 


value for the MAXIMUM ADDRESS 


p a 


r 


a m e t e 


r is 



SET EXECUTOR MAXIMUM ADDRESS 255 



Set the iriaxiwu m n umber of routing nodes ( excl u d i n g this 
node) on the Ethernet simultaneously. The 1 e g a 1 range for 
the BROADCAST ROUTERS parameter is 1 to 33 inclusive, The 
default value for this parameter is 10, 



SET EXECUTOR MAXIMUM BROADCAST ROUTERS 10 



(continued on next page) 



Example 4-3: Configuration File for Server with Synchronous and Asynchronous Lines 



3 ♦ Set the m a x i m u m n u iiiber of n onroutiriS nodes on the Ethernet 
simultaneously* The 1 e 3 a 1 ranSe for the BROADCAST 



NONROUTERS 


pa 


r 


a m e t 


e r is to 


1022 i n c 1 u s i u 


e . 




The d 


e 


f 


a u 1 


t 


value for 


th i 


5 


par 


a meter is 3 


2 ♦ The n u m ber 





f 


n o n r 





u 


t e r 


5 


will be s e 


t t 





the 


m a x i m u m a d 


dress mi n u s o 


n e 




if th 


e 




n u m 


ber 


of no n rout 


e r s 




is a 


reater than 


the maxim u m 


ad 


d 


r e s s 


m 


i 


n u s 





5 one. 

SET EXECUTOR MAXIMUM BROADCAST NONROUTERS 32 

? 





Se 


t the to 


t 


al 




n u m b 


e 


r of h 


P 


s from t 


he DECn 


e 


t 




R 


o u t 


e 


r 




S 


e 


r 


i.) e r 




to 


a n y o t h 


e 


r 


r 


each 


a 


b 1 e n o 


de 


in the 


n e t w o r k 






A 




r e m 





t 


e 




n 





de 




i s 


u n r e a c h 


a 


b 1 


e 


o u e 


r 


a pat 


h 


if the n 


u m ber o 


f 




h 





p s 


r 


e 


q 


u 


i 


r 


ed 




to 


5 e t to 


i 


t 


e 


x c e e 


d 


s the 


u a 


1 ue set 


for t h i 






p 


a 


r am 


e 


t 


e 


r 






The 




1 e 


Sal rana 


e 


f 





r t h 


e 


HOPS 


pa 


r a m e t e r 


i s 2 t o 




3 







i n c 


1 


u 


5 


i 


M 


e 


* 




Th 


e d e f a u 1 


t 


M 


a 


1 u e 


f 


or t h i 


5 


para mete 


r is 20 



























1 

SET EXECUTOR MAXIMUM HOPS 20 

5 



5. Set the total 


cost 


from 


the 


DECnet Rout 


e r S e r 


u e r to 


an 




other reachab 


1 e no 


d e i n 


the 


n e t w o r K ♦ A 


remote 


n ode 


i s 




unreachable o 


m e r a 


path 


i f 


the cost r e <=i 


u i red 


to det 


t 


i t 


exceeds the u 


a 1 u e 


set f 


or t 


his para mete 


r . The 


1 e da 1 


r a 


n 3 e 


for the COST 


parain 


e t e r 


is 2 


to 1022 i n c 


1 u s i u e 


. The 


def 


a u 1 


u a 1 u e for t h i 


s par 


a m e t e 


r is 


1022 ♦ 










SET EXECUTOR MA 


XI MUM 


COST 


102 













(continued on next page) 

Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



B. Set the BUFFER SIZE for the DECnet Router Server. These 

buffers are used for the intermediate storage of all user 
data beind transmitted or received. Legal range for the 
BUFFER SIZE parameter is 24S to 1484 inclusive. The 
default value for this parameter is 5 7 G » 

SET EXECUTOR BUFFER SIZE 57S 

7. Set the SEGMENT BUFFER SIZE. This parameter allows nodes 
with different buffer sizes to communicate efficiently. 
The legal range for the SEGMENT BUFFER SIZE parameter is 
24G to 14GG inclusive, The default value for this 
parameter is 5 7 G , 



SET EXECUTOR SEGMENT BUFFER SIZE 57G 

Set the line characteristics ( SPEED t DUPLEX > MODEM control) 
for each point-to-point connection from the DECnet Router 
Server, The options for each parameter are the following: 

The speed range varies depending on your configuration, 
ChecK the DECnet Router Server Installation guide for the 
proper values, The total bandwidth for the point-to-point 
lines must not exceed 5 K i 1 o b a u d , 

The duplex parameter for the line can be DUPLEX FULL or 
DUPLEX HALF, 



The modem control parameter can be MODEM YES or MODEM NO, 

(continued on next page) 



Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



The default values for these parameters are SPEED 9600 » 
DUPLEX FULL and MODEM YES. The leSal devices are LC-1 
through LC-8 and LC-# ( If the lines are asynchronous* 
specify L or R following the line number to indicate the 
left and r i h t part of the line card. The default is 
s y n c h r o n o u s ♦ 



s> 


n c h r o n o u s 














SET 


LINE 


LC- 


1 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 




SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 


3 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 


a 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 


5 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 


G 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


LINE 


LC- 


7 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


SET 


L I NE 


LC- 


8 


SPEED 


9800 


DUPLEX 


FULL 


MODEM Y 


ES 


As 


y n c h 


r o n o u s 














SET 


LINE 


LC- 


1L 


SPEED 


9G0< 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


1R 


SPEED 


9B0f 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


2L 


SPEED 


960 c 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


2R 


SPEED 


9S0< 


]) DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


3L 


SPEED 


9S0( 


5 DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


3R 


SPEED 


9B0c 


) DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


4L 


SPEED 


9B0< 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


4R 


SPEED 


9B0< 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


5L 


SPEED 


360i 


:> DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


5R 


SPEED 


360( 


5 DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


GL 


SPEED 


960c 


) DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


BR 


SPEED 


960c 


3 DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


7L 


SPEED 


360c 


) DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


7R 


SPEED 


960( 


3 DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


8L 


SPEED 


9S0( 


:i DUPLEX 


FULL 


MODEM 


YES 


SET 


LINE 


LC- 


8R 


SPEED 


9B0f 


:> DUPLEX 


FULL 


MODEM 


YES 



f 

CO 



(continued on next page) 

Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



i 9, Set the circuit characteristics (COST > HELLO TIMER * STATE) 

5 for the point-to-point circuits from the DEC net Router 

5 Server. The 1 e a 1 range for the cost parameter is 1 to 25 

5 inclusive* This sets the path cost between the DEC net 

5 Router and the adjacent node on the circuit* The 1 e & a 1 

5 rande for the HELLO TIMER parameter is 3 to 8191. The 

5 HELLO TIMER is the rate in seconds that idle transport 

5 messages are sent to maintain reachability* The options for 

i the state parameter are STATE ON or STATE OFF. The default 

5 values for COST ♦ HELLO TIMER and STATE are 1, 15 seconds 

5 and off respectively. 

5 



Si 


' n c h r o n o 


11 5 
















SET 


CIRCUIT 


LC- 


1 


COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 




COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


3 


COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


a 


COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


5 


COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


S 


COST 1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC- 


7 


COST 1 


HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


8 


COST 1 


HELLO 


TIMER 


15 


STATE 


OFF 


A s v n c h r o n o u s 
















SET 


CIRCUIT 


LC- 


1L 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


1R 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


2L 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


2R 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


3L 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


3R 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


4L 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


4R 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


5L 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC- 


5R 


COST 


1 HELLO 


TIMER 


15 


STATE 


OFF 
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Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



SET 


CIRCUIT 


LC 


-SL 


COST 


1 


HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC 


-BR 


COST 


1 


HELLO 


TIMER 


15 


STATE 


OFF 


SET 


CIRCUIT 


LC 


-7L 


COST 


1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC 


-7R 


COST 


1 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC 


-BL 


COST 


l 


HELLO 


TIMER 


15 


STATE 


ON 


SET 


CIRCUIT 


LC 


-8R 


COST 


i 


HELLO 


TIMER 


15 


STATE 


ON 



10. Set the circuit UNA-0 parameters (COST, ROUTING PRIORITY* 
HELLO TIMER). The COST and HELLO TIMER parameters have the 
same attributes and defaults as described above for L C 
circuits. The ROUTING PRIORITY parameter designates which 
router will serve the Ethernet. If two routine nodes have 
the same priority* then the node with the higher node 
address will be the designated router for the Ethernet. 
The leaal ranSe for the ROUTING PRIORITY parameter is to 
127 inclusive. The default for this parameter is 100. 

SET CIRCUIT UNA-0 COST 1 ROUTING PRIORITY 100 HELLO TIMER 15 



1 1 . 


Se 


t 


the TRANSMIT PASSNORD » wh 


i c 


h 


the ex 


ecttt 





r n 





de 


m u s t 




t r 


an 


s m i t to an adjacent node 


du 


r i 


n si a n 


ode 


i 


n i t 


i 


al 


i z at i 




s e 


=1 u 


e n c e ♦ The password is one 


t 





e i £h t 


ASCI 


I 


c h 


a 


r a 


c t e r s 




Th 


e 


default for this para mete 


r 


i s 


no pa 


5 5 W 


r 


d . 









SET EXECUTOR TRANSMIT PASSWORD DECNET 
12. Set the RECEIVE PASSWORD t which the executor node expects 



? to receive from an adjacent node during a n ode 

5 initialization sequence. The password is one to eisht 

5 ASCII characters. The default for this parameter is no 

5 password. 

? 

5 SET EXECUTOR RECEIVE PASSWORD DECNET 



(continued on next page) 

Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



o 



13 



Set th 


e MAXIMUM 


AREA 




n u m b e r 


i 


n 


legal 


ranSe for 


this 




p a r a ft) e t 


e 


r 


this p 


a r a m e t e r 


is s p 


e 


c i f i e d * 




th 


an are 


a router. 


The 


d 


e f a u 1 1 


M 


al 


p a r a m e 


t e r is 1 e 


uel 1 




r o u t i n g 




on 


doc u m e 


n t a t i o n w 


hen c 





n f i g u r i 


)-| 


si 



the D E C n e t network* The 

is 2 to G 3 inclusive* If 

e D E C n e t Router will b e c o irt e 

ue for the MAXIMUM AREA 

1 y . Refer to the 

areas. 



SET EXECUTOR MAXIMUM AREA 63 



D 

m 
o 

CD 

<-+• 

33 
O 
c 
i-*- 
CD 

CO 

o 

—¥* 
I— »■ 

0) 
CD 

5" 

CO 
«-*■ 

o' 

O 
c 

Cl 
CD 



14, 



Set the total number of area hops from the DEC net Router 

Server's area to any other reachable area in the n e t w o - L ' 

A remote area is unreachable over a path if the number 

hops required to get to it 



the network. 

of 

. _ _ exceeds the value set for this 
parameter. The legal range for the AREA HOPS parameter is 
2 to 30 inclusive. If this parameter is specified* the 
D E C n e t Router will become an area router. The default 
value for the AREA HOPS parameter is level 1 routing only. 
Refer to the documentation when configuring areas. 

SET EXECUTOR MAXIMUM AREA HOPS 20 

15. Set the total cost from the DECnet Router Server's area to 
any other reachable area in the network. A remote area is 
unreachable over a path if the cost required to get to it 
exceeds the value set for this parameter. The legal range 
for the AREA COST parameter is 2 to 1022 inclusive. If 
this parameter is specified* the DECnet Router will become 
an area router. The default value for this parameter is 
level 1 routing only. Refer to the documentation w h e n 
configuring areas. 

SET EXECUTOR MAXIMUM AREA COST 1022 

Example 4-3 (cont.): Configuration File for Server with Synchronous and Asynchronous Lines 



4.4 How the DECnet Router Server Handles Configuration File 
Errors 



When you load the DECnet Router Server, the software checks the syntax of the 
commands in the configuration files and checks that all parameter values are valid. 
The DECnet Router Server checks the network configuration file first, then the router 
configuration file. If you do not specify a parameter value to a command in either of 
these files, or if the command syntax or a parameter value in either file is invalid, the 
software uses the default value. The software reports all errors to the event logger on 
the DECnet Router Server's maintenance host (which normally is the loading host). 
The event logger displays the event messages on the host's console or monitor (on a 
VMS host). The software will not stop processing the configuration files or crash the 
node, regardless of the errors detected, unless a halt error condition occurs. A halt 
error condition occurs when a serious error cannot be corrected by reloading the 
software. The DECnet Router Software Management Guide lists all halt error mes- 
sages and event messages generated by the DECnet Router Server. The network 
configuration file event error messages are of the class 225. Following is an example of 
an event error message reported on an RSX host during a syntax check of the network 
configuration file: 

Event Type 225*0 
Occurred 1 -Jul -83 09:00:17 on node 271 (RTR32) 
SET EXECUTOR BACKUP HOSTS MAX1, MAX2 » MAX 3 t MAX4 * MAX5 » >> MAXE 
Too many BACKUP HOSTS specified 

This message informs you that you specified too many backup hosts. The limit is five. 

The router configuration file event error messages are of the class 226. Following is an 
example of an event error message reported on an RSX host during a syntax check of 
that file: 

Event Type 22B.0 
Occurred l-Nou-83 09:10:00 on node 271 (RTR32) 

SET EXECUTOR MAXIMUM ADDRESS >> 2000* MAXIMUM ADDRESS out of 
ranSe. 

This message informs you that you specified an invalid maximum address. The maxi- 
mum is 1023. The default maximum address of 255 will be used. 

The software also reports any errors that occur when attempting to process the config- 
uration file commands. When you load the software, note any errors logged at the 
maintenance host system's console. Correct the errors by editing the appropriate 
configuration files, then reload the software. 
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Loading the Server Software and Checking the 

Installation 



This chapter explains how to load the DECnet Router Server software and check that 
it works, and how to copy server files to other hosts that might be called on to load the 
server software. 

5.1 Loading the DECnet Router Server Software 

You load the DECnet Router Server by having the software down-line loaded from the 
loading host to the server hardware unit. You can do this in any of the three ways 
listed below and described in Sections 5.1.1 through 5.1.3. 

Before trying to load the DECnet Router Server, make sure that: 

• Installation is complete and the down-line load database is set up on the loading 
host. 

• The UNA line is loaded on the host (the UNA line over which the host will down- 
line load the software). Use the following NCP command: 

SET LINE UNA-rc ALL 

where n identifies the UNA circuit on the host. 

• The UNA circuit at the host is set to the ON state. Use the following NCP com- 
mand: 

SET CIRCUIT UNA-rc STATE ON 

The line must be loaded before you can turn on the circuits. 
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• The UNA circuit at the host is enabled for service operations. (Service operations 
include down-line loading, up-line dumping, and loopback testing.) Use the follow- 
ing NCP command: 

SET CIRCUIT UNA-n SERVICE ENABLED 

On VMS hosts, the circuit must be off before you can enable it for service. To turn 
off the circuit and then enable the circuit for service, use the following NCP com- 
mands: 

SET CIRCUIT UNA-n STATE OFF 

SET CIRCUIT UNA-rc SERVICE ENABLED STATE ON 

• The server hardware unit is turned on. If not, turn the OFF/ON/LOCK switch to 
the ON position. This will automatically start the load process. 

• Event logging is enabled at any host that might load the server. The server logs 
events at the maintenance host, which by default is the loading host. 

To enable event logging at the host, use the following NCP command: 

SET LOGGING CONSOLE STATE ON 

On VMS hosts, you can also enable logging at the system monitor as follows: 
SET LOGGING MONITOR STATE ON 

When you load the DECnet Router Server, it generates several event messages to 
inform you of stages of the loading process and the success or failure of the loading 
processes, as described in Section 5.1.4. These messages can help you troubleshoot 
any problems that might arise. 

The DECnet Router Software Management Guide explains how to set up and 
change event logging for events generated by the server node. You can also have 
events logged at other nodes. 

The three ways to load the DECnet Router Server are: 

1 Use the NCP LOAD NODE command at a terminal connected to the loading 
host, as explained in Section 5.1.1. With this command, the load occurs from the 
host at which you execute the command. Also, you can specify additional parame- 
ters to override parameter values set in the down-line load database on the host. 
See Appendix C. 

2 Use the NCP TRIGGER NODE command at a terminal connected to any DECnet 
host on the Ethernet, as explained in Section 5.1.2. The TRIGGER command 
produces similar results as the LOAD command, but any suitable host can load 
the server. You cannot be sure what host will load the server, but an event 
message will inform you after the load. 

You can specify additional parameters to override parameter values set in the 
down-line load database on the host. 

The TRIGGER command has the same effect as does loading the software by 
pressing the START button on the hardware unit. 
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3 Press the START button on the front panel of the Communications Server hard- 
ware unit, as explained in Section 5.1.3. Using the START button on the server is 
the fastest method of loading the server. 



All three methods produce the same results when loading the server for the first time. 

Section 5.1.4 describes the various phases of the loading process and the event mes- 
sages you should see at the loading host (or maintenance host). 

NOTE 

You can prevent a specific node from down-line loading the software 
or from receiving an up-line dump from the server node and specify 
an alternate node to provide the service. You may want to do this if 
the loading node is not available or if you want to prevent unauthor- 
ized reloads of the software from certain remote nodes. To stop a node 
from down-line loading or receiving up-line dumps, use the NCP 
CLEAR NODE server-node-id NAME command on this node, where 
server-node-id identifies the server node. 

5.1.1 Using the LOAD Command 

Issue the NCP LOAD command using the following format: 

LOAD NODE server-node-id 

where server-node-id identifies the server node. 

If for security reasons you have set up all down-line load parameters on the host 
except the service password, the password must be specified with the LOAD com- 
mand as follows: 

LOAD NODE server-node-id SERVICE PASSWORD hex-password 

where hex-password specifies the hexadecimal password, in the range of to 
FFFFFFFFFFFFFFFF . This must match the UNA password defined in the DECnet 
Router Server's network configuration file. 

Figure 5-1 shows the LOAD command being used on HOST1 for down-line loading 
server node RTRDEV over the Ethernet, on circuit UNA-0. The arrow shows the path 
that HOST1 uses to down-line load the software onto the server node. 

NOTE 

If you issue the NCP LOAD command while the TEST button on the 
server hardware unit is in, then NCP ignores the state of the TEST 
button and sends the server system image, not the diagnostic image. 
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Figure 5-1: Using the LOAD Command 



5.1.2 Using the TRIGGER Command 

Issue the NCP TRIGGER command using the following format: 

TRIGGER NODE server-node-id 

where server-node-id identifies the server node. 

If for security reasons you have set up all down-line load parameters on the host 
except the service password, the password must be specified with the TRIGGER 
command as follows: 

TRIGGER NODE server-node-id SERVICE PASSWORD hex-password 

where hex-password specifies the hexadecimal password, in the range of to 
FFFFFFFFFFFFFFFF . This must match the UNA password defined in the DECnet 
Router Server's network configuration file. 

Use the TRIGGER VIA command, in the format shown in Appendix C, to specify the 
circuit over which the software is loaded. Figures 5-2 through 5-4 show the three 
phases that occur after you use the TRIGGER command to down-line load the server 
node RTRDEV over the Ethernet. 
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Figure 5-2: The TRIGGER Command: (1) Trigger Is Sent to the Server 



1 First, as shown in Figure 5-2, the host where the command is issued will send the 
trigger to RTRDEV over circuit UNA-0. (Before the host can send the trigger, it 
first checks its database for node RTRDEV to find the physical address of the 
server. The down-line load database for node RTRDEV was set up on each poten- 
tial loading host, as shown in Figures 2-1 and 2-2.) The arrow shows the path that 
HOST1 uses to send the trigger message to the server node. 

2 Next, the Communications Server hardware unit responds to the trigger by send- 
ing a request-to-load message to all DECnet host nodes on the Ethernet, as shown 
by the arrows in Figure 5-3. 

3 As shown in Figure 5-4, the host that loads the server is the first host to respond 
that has the down-line load information for that server. Event messages that 
record the sequence of events during the load process are logged at the loading 
host's logging console (or logging monitor on VMS systems). 

If you want the host from which you are issuing the TRIGGER command to be able to 
do the load, make sure the UNA circuit has been service enabled before issuing the 
TRIGGER command. Use the following NCP command: 

SET CIRCUIT UNA-0 SERVICE ENABLED 
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Figure 5-3: The TRIGGER Command: (2) Multicast Request-to-load Message 
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Figure 5-4: The TRIGGER Command: (3) First Host to Respond Loads the 
Server 
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NOTE 



If you issue the TRIGGER command while the TEST button on the 
server hardware unit is pushed in, then the unit will load the loadable 
diagnostics image (LDI) instead of the DECnet Router Server system 
image. See the DECnet Router Software Management Guide. 

5.1.3 Starting the Load at the Server Hardware Unit 

At the Ethernet Communications Server hardware unit, start the load of the software 
by first checking that the POWER switch is ON, and then pressing the START 
button on the front panel of the unit, as shown in Figure 5-5. The inset shows the 
front panel of the unit. (Turn the switch to the LOCK position to prevent unauthor- 
ized or inadvertent reloads. In the LOCK position, the START button is disabled. 
The LOCK position also prevents someone from forcing a crash of the server from a 
host.) 

Figures 5-5 and 5-6 show what happens when you initiate the load at the hardware 
unit. 

1 First, as shown in Figure 5-5, the Communications Server hardware unit responds 
by sending a request-to-load message to all DECnet host nodes on the Ethernet. 

2 Then, the first host to respond (the first available host that has the down-line load 
information for that server) is the host that loads the server. Figure 5-6 shows that 
the loading host is HOST1. 

During a successful load, you will first see the unit's digital display blinking, then you 
will see: 

L 30 

This can last up to 30 seconds. After this, you will see: 
L 5n 

where n is a digit that cycles from to 7 repeatedly, indicating that the software 
image is being loaded. This can last a couple of minutes. When the server node comes 
up and the server has initialized all lines, a cyclic pattern shows on the server hard- 
ware unit's digital display, as shown in figure 5-6. Intermittently, the display shows 
the server's DECnet node number. The DECnet node number distinguishes commu- 
nications servers located in the same vicinity. This node number is defined in the 
databases on each host node in the LAN and on other nodes that will communicate 
with the server node. (As system or network manager, you must make sure that the 
server's node number is known to all these nodes.) You can use the node number to 
identify the server node when issuing network management commands. (Normally 
you use the server's node name.) 
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Figure 5-5: Load Started at the Hardware Unit: (1) Multicast Request-to-load 
Message 
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If an error occurs during or after the load, one of the fault indicators may light up and 
the digital display will show error information. Refer to the DECnet Router Software 
Management Guide for a listing and the meaning of all codes that can be displayed. 

When the server node comes up, you are ready to run the installation checkout 
procedure described in Section 5.2. 




TW040 

Figure 5-6: Load Started at the Hardware Unit: (2) First Host to Respond Loads 
the Server 
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5.1.4 The Loading Process and Event Messages 

The loading process, which takes several minutes, goes through the following three 
phases: 

1 A primary loader, contained in the server's Ethernet controller, loads the second- 
ary loader (PLUT02.SYS) into the controller and starts the secondary loader. 

2 In turn, the secondary loader loads the tertiary loader (PLUT03.SYS) into server 
memory and starts the tertiary loader. 

3 The tertiary loader loads the system image (CSVRTR.SYS, CSVRTR16L.SYS, or 
CSVRTR32L.SYS) into server memory. This can last a couple of minutes, after 
which the tertiary loader also passes host-supplied parameters to the system im- 
age, such as the server's node name and number, and the host's node number. 
Finally, the tertiary loader starts the system image. 

During each phase of the load, the host issues two DECnet event messages. The first 
of each pair of events indicates the load phase has been requested. The second indi- 
cates whether the load was successful. Other messages follow. The event messages 
may vary slightly on different host systems. Sections 5.1.4.1 and 5.1.4.2 show the 
event messages seen from VMS and RSX loading hosts. (Also, during the load, the 
codes described in Section 5.1.3 are displayed on the front panel of the Ethernet 
Communications Server hardware unit. These codes are displayed whether the load is 
invoked at the hardware unit or by command at a host.) 

Event messages of type 225 are for events that occur before and during the initializa- 
tion of the network configuration file. Event messages of type 226 are for errors that 
occur during initialization of the router configuration file, and for any subsequent 
errors. Event messages of types 225 and 226 also record status changes, such as the 
"Server initializing" and "Server up" events. No errors during these phases are fatal, 
but the server can halt. The server attempts a reload after crash dumps; however, the 
server halts on errors for which a reload would not be of any avail. See the DECnet 
Router Software Management Guide. 

When the software finds errors in the configuration files, the event message shows 
which command is in error and the nature of the error. The software scans the 
remainder of the configuration file so that all possible syntax and invalid parameter 
values are detected and reported at one pass. You should correct these reported 
configuration file errors and then load the software again. 

NOTE 

Syntax errors or invalid parameter values in the network configura- 
tion file will not prevent the server from loading. (The server will use 
default values for the affected parameters.) 
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If you start the load at a terminal, and the server fails to come up for reasons other 
than software errors, you may have to try starting the load at the hardware unit, as 
described later. 

Once the software is loaded without error and the server comes up, you are ready to 
perform the installation checkout procedure as described in Section 5.2. 

5.1.4.1 Events During a Load from VMS Host — Assuming the loading host is 
VMCENT, a VMS system, and the server node is RTRDEV with three point-to-point 
lines connecting nodes ELROND (50), HAZEL (45), and AARON (275), the following 
are the events normally seen during the load of the DECnet Router Server software. 

NOTE 

Because many events occur in a short time, certain event messages 
may not be logged. The following event message warns you of this: 

DECnet event . t Event records lost 

From node 134 (RTRDEV) t 25-AUG-84 16:00:01 

vrn:r/j:m:rL opcom 25-aug-84 16:41:04.42 

Message from user DECnet on VMCENT 

DECnet event 0.3* automatic line service 

From node 120 (VMCENT) t 25-AUG-84 IB: 41:03* 53 

Circuit UNA-Ot Load* Requested* Node = 134 ( RTRDEV ) 

File = PL.UT02.SYSt Secondary loader 

zzvr/:rn:m:i opcom 25-aug-84 ig:41: 04.59 

Message from user DECnet on VMCENT 

DECnet event . 3 t automatic line service 

From node 120 (VMCENT) t 25 -AUG -84 IS: 41: 

Circuit UNA-Ot Load* Successful t Node = 134 (RTRDEV) 

File = PLUT02.SYS* Secondary loader 

rUJ»17,J,r/,rn,2 OPCOM 25-AUG-84 1S:41:05.01 
Message from user DECnet on VMCENT 
DECnet event . 3 t automatic line service 
From node 120 (VMCENT) t 25-AUG-84 16:41:05.00 
Circuit UNA-Ot Load* Requested t Node = 134 (RTRDEV) 
File = PLUT03.SYS* Tertiary loader 

ruryjy,rr/rry,ru, opcom 25-aug-84 is:4i:05.58 

Message from user DECnet on VMCENT 

DECnet event . 3 t automatic line service 

From node 120 (VMCENT) t 25-AUG-84 16:41:05.38 

Circuit UNA-Ot Load* Successful » Node = 134 (RTRDEV) 

File = PI_UT03.SYSt Tertiary loader 

1111117.J.rU,l OPCOM 25-AUG-84 16:41:06.00 
Message from user DECnet on VMCENT 
DECnet event 0.3 t automatic line service 
From node 120 (VMCENT) t 25-AUG-84 16:41:05.88 
Circuit UNA-Ot Load » Requested* Node = 134 (RTRDEV) 
File = CSVRTR.SYSt Operating system 

1 "/.. "L 1 1 "I "/.. "I "I "I "L OPCOM 25-AUG-84 1G:41:06.31 
Message from user DECnet on VMCENT 
DECnet event 0.3t automatic line service 
From node 120 (VMCENT) t 25-AUG-84 16:42:06.21 
Circuit UNA-Ot Loadt Successful t Node = 134 (RTRDEV) 
File = CSVRTR.SYSt Operating system 
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The following message shows that the server has come up as a DECnet node. The 
configuration files have been read, and the server is reconfiguring, using the informa- 
tion supplied by the configuration files. The message identifies the software version of 
the DECnet Router Server and the system image (8L denotes the 8 synchronous line 
configuration, 16L the 16 line maximum configuration, 32L for the 32 line maximum 
configuration) . 

DECnet event 225,0 

From node 134 (RTRDEV), 25-AUG-84 18:43:19,29 
Parameter #0 = Server initializing* 
Identification = DECnet Router Server V 1 ♦ 1 8 L 

The following event messages show that the server now sees the loading host 
(VMCENT) and other nodes on the Ethernet as active adjacent nodes. 

DECnet event 4 , 1 5 > adjacency up 

From node 134 (RTRDEV) » 25-AUG-84 18:43:49,83 
Circuit UNA-0* Adjacent node = 120 (VMCENT) 
DECnet event 4 ♦ 1 5 t adjacency up 

From node 134 (RTRDEV) » 25-AUG-84 18:43:55,32 
Circuit UNA -Of Adjacent node = 340 (BACH) 

DECnet event 4 , 1 5 > adjacency up 

From node 134 (RTRDEV) t 25-AUG-84 18:43:58,09 
Circuit UNA-0* Adjacent node = 41 (MOZART) 

DECnet event 4 ♦ 1 5 * adjacency up 

From node 134 (RTRDEY)* 25-AUG-84 18:43:58,34 
Circuit UNA-0 > Adjacent node = 10 (BRAHMS) 



You will also see sometimes the following messages showing that the point-to-point 
(LC) circuits have come up: 

DECnet event 4 , 1 > Circuit up 

From node 134 ( R T R D E ) > 25-AUG-84 18:44:02,43 
Circuit LC-1 

Node address = 50 ( ELROND ) 
DECnet event 4,10* Circuit up 

From node 134 (RTRDEY)* 25-AUG-84 18:44:05,38 
Circuit LC-2 

Node address = 45 (HAZEL) 
DECnet event 4,10* Circuit up 

From node 134 (RTRDEV)* 25-AUG-84 18:45:01:01 
Circuit LC-3 

Node address = 275 (AARON) 
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When configuration completes without error, the DECnet Router Server's remote 
event logging facility sends the following event message which shows that the system 
is now running. 

DECnet event 226.0 

From node 134 (RTRDEV). 25-AUG-84 16:45:02.21 

Server up* Identification = DECnet Router Server V 1 ♦ 1 S L 

5.1.4.2 Events during a Load from an RSX Host — The following are events 
normally seen on an RSX loading host. The loading host is HOST1, and the DECnet 
Router Server is RTRDEV. (The down-line load database on HOST1 is the one set up 
in Figure 2-2.) RTRDEV has three point-to-point lines connecting nodes ELROND 
(50), HAZEL (45), AARON (275). 

NOTE 

Because many events occur in a short time, certain event messages 
may not be logged. The following event message will warn you of this: 



E v e n t type . * Event records lost 
Occurred AUG-25-84 16:40:04 on node 134 (RTRDEV) 

E v e n t type . 3 t Automatic service 
Occurred AUG-25-84 16:41:04 on node 245 (H0ST1) 
Circuit UNA-0 
Service type = Load 
Status = Requested 

Node = 134 (RTRDEV) f File = DLO : [ 1 00 » 1 00 ] PLUT02 . SYS 
Software type = Secondary loader 

Event type 0.3* Automatic service 
Occurred AUG-25-84 16:41:04 on node 245 (H0ST1) 
Circuit UNA-0 
Service type = Load 
Status = Successful 

Node = 134 (RTRDEV). File = DLO : E 100 » 100 3 PLUT02 ♦ SYS 
S o f t w a r e type = Secondary loader 

Event type 0.3. Automatic service 
Occurred AUG-25-84 16:41:05 on node 245 (H0ST1) 
Circuit UNA-0 
Service type = Load 
Status = Requested 

Node = 134 (RTRDEV) . File = DLO : C 1 00 » 1 00 1 PLUT03 . SYS 
Software type = Tertiary loader 

Event type ♦ 3 » Automatic service 
Occurred AUG-25-84 16:41:06 on node 245 (H0ST1) 
Circuit UNA-0 
Service type = Load 
Status = Successful 

Node = 134 (RTRDEV)* File = DLO : E 1 00 » 1 00 3 PLUT03 ♦ SYS 
Software type = Tertiary loader 

(continued on next page) 
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18:41:07 on node 245 (H0ST1 



» File = DLO: I 100 » 100 ] CSVRTR . SYS 



t o m a t i c service 

IB: 41: 58 on node 245 (H0ST1) 



» File = DLO : C 1 00 f 1 00 3 CSMRTR , SYS 



The next message indicates that the server has come up as a DECnet node. The 
configuration files have been read, and the server is reconfiguring, using the informa- 
tion supplied by the configuration files. The message identifies the software version of 
the DECnet Router Server and the system image (8L denotes the 8 synchronous line 
configuration, 16L the 16 line maximum configuration, 32L for the 32 line maximum 
configuration) . 

Event type 225,0 
Occurred AUG-25-84 16:42:35 on node 134 (RTRDEM) 

Server initializing » Identification = DECnet Router Server M 1 . 1 8 L 



Next, the server sends the following messages showing that it now sees the loading 
host (node 245, HOST1) and other nodes on the Ethernet as active adjacent nodes. 



Event type 4 ♦ 1 5 > Adjacency u p 

Occurred AUG-25-84 18:43:09 on node 134 (RTRDEM) 
Circuit UNA-0 

Adjacent node = 245 (H0ST1) 



Event type 4 ♦ 1 5 > Adjacency 
Occurred AUG-25-84 18:43:11 
Circuit UNA-0 

Adjacent node = 340 (BACH) 

Event type 4 « 1 5 t Adjacency 
Occurred AUG-25-84 18:43:11 
Circuit UNA-0 

Adjacent node = 41 (MOZART) 



u p 

on node 134 (RTRDEM) 



u p 

o n n ode 



134 (RTRDEM) 



Event type 4 . 1 5 t Adjacency u p 
Occurred AUG-25-84 18:43:13 on node 134 (RTRDEM) 
Circuit UNA-0 

Adjacent node = 10 (BRAHMS) 
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You will also see the following messages showing that the point-to-point (LC) circuits 
have come up: 

Event type 4 . i t Circuit u p 
Occurred AUG -25 -84 IB: 44: 03 on node 134 (RTRDEU) 
Circuit LC - 1 

Node address = 50 (ELROND) 

Event type 4 . 1 t Circuit u p 
Occurred AUG-25-84 16:44:04 node 134 (RTRDEU) 
Circuit LC-2 

Node address = 45 (HAZEL) 

Event type 4 4 1 > Circuit u p 
Occurred AUG-25-S4 16:44:23 node 134 (RTRDEV) 
Circuit LC-3 

Node address = 275 (AARON) 



When configuration completes without error, the DECnet Router Server's remote 
event logging facility sends the following event message which shows that the system 
is running. 

Event type 226 ♦ 
Occurred AUG-25-84 16:43:51 on node 134 (RTRDEU) 
Server up* Identification = DECnet Router Server U 1 ♦ 1 8 L 



5.2 Checking out the Installation from VMS and RSX Hosts 

To verify that your DECnet Router Server has been installed correctly, use the instal- 
lation checkout procedure (ICP) at a terminal on any host system. This procedure 
checks the connectivity of your DECnet Router Server with all adjacent remote nodes. 
Before invoking this procedure, have a firm understanding of the current network 
configuration. If the procedure reveals that something is not working, you must cor- 
rect the source of the problem. 

You will invoke one of three ICP command files, depending on your DECnet Router 
Server configuration: 

CSVRTRICP The ICP command file for the 8-line synchronous-only configuration 
(CSVRTR.SYS) 

CSVRTR16L The ICP command file for the single-PAM synchronous/asynchro- 
nous configuration (CSVRTR16L.SYS), 16 line maximum. 

CSVRTR32L The ICP command file for the dual-PAM synchronous/asynchronous 
configuration (CSVRTR32L.SYS), 32 line maximum. 
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5.2.1 Before Starting ICP 



Before starting, edit the appropriate command file to enable the commands that test 
the communications lines installed on your server. (All commands in the ICP file are 
set up as comments.) On a VMS host, edit the file with the .COM extension, enabling 
the commands by removing the exclamation point (!) that precedes each command. 
On an RSX host, edit the file with the .CMD extension, enabling the commands by 
removing the semicolon (;) that precedes each command. 

For example, assume you are going to check out the DECnet Router Server RTRDEV 
from a VMS host VMHOST. RTRDEV has five synchronous lines on a single-PAM 
system supporting synchronous lines only (CSVRTR.SYS). Therefore, you will use 
the command file CSVRTRICP.COM. 

First, enable the commands for lines LC-1 through LC-5, as shown below. The excla- 
mation marks for the three unused lines (LC-6 through LC-8) are left intact. 



$ 


NCP 


TELL 


'NODE ' 


USER 


E i 


1 1 3 


PASS 


' PASS ' 


SET 


NODE 


LCI 


CIR 


LC- 


1 


$ 


NCP 


TELL 


'NODE ' 


USER 


E 1 


» 1 3 


PASS 


' PASS ' 


LOOP 


NODE 


LCI 








$ 


NCP 


TELL 


'NODE ' 


USER 


C 1 


» 1 ] 


PASS 


' PASS ' 


CLE 


NODE 


LCI 


CIR 






$ 
$ 


NCP 


TELL 


'NODE ' 


USER 


C 1 


»1 3 


PASS 


' PASS ' 


SET 


NODE 


LC2 


CIR 


LC- 




$ 


NCP 


TELL 


'NODE ' 


USER 


C 1 


» 1 3 


PASS 


' PASS ' 


LOOP 


NODE 


LC2 








$ 
* 


NCP 


TELL 


'NODE ' 


USER 


[ 1 


1 1 3 


PASS 


' PASS ' 


CLE 


NODE 


LC2 


CIR 






$ 


NCP 


TELL 


'NODE ' 


USER 


E 1 


f 1 3 


PASS 


' PASS ' 


SET 


NODE 


LC3 


CIR 


LC- 


3 


$ 


NCP 


TELL 


'NODE ' 


USER 


E 1 


tl 3 


PASS 


'PASS ' 


LOOP 


NODE 


LC3 








$ 


NCP 


TELL 


'NODE ' 


USER 


E 1 


1 1 3 


PASS 


'PASS ' 


CLE 


NODE 


LC3 


CIR 






$ 
$ 


NCP 


TELL 


' NODE ' 


USER 


E 1 


» 1 3 


PASS 


' PASS ' 


SET 


NODE 


LC4 


CIR 


LC- 


a 


$ 


NCP 


TELL 


' NODE ' 


USER 


C 1 


»1 3 


PASS 


' PASS ' 


LOOP 


NODE 


LC4 








$ 
$ 


NCP 


TELL 


'NODE ' 


USER 


E 1 


♦ 13 


PASS 


' PASS ' 


CLE 


NODE 


LC4 


CIR 






* 


NCP 


TELL 


'NODE ' 


USER 


E 1 


» 1 3 


PASS 


'PASS ' 


SET 


NODE 


LC5 


CIR 


LC- 


5 




NCP 


TELL 


' NODE ' 


USER 


E 1 


» 1 3 


PASS 


' PASS ' 


LOOP 


NODE 


LC5 










NCP 


TELL 


' NODE ' 


USER 


E 1 


» 1 3 


PASS 


' PASS ' 


CLE 


NODE 


LC5 


CIR 







$ ! 




$ ! 


NCP 


$ ! 


NCP 


* ! 


NCP 


* ! 

* ! 


NCP 


$ ! 


NCP 


$ ! 


NCP 


$ ! 




$ ! 


NCP 


$ ! 


NCP 


$ ! 


NCP 



'NODE 
'NODE 
' NODE 



USER El 
USER El 
USER El 



NODE ' USER El 



TELL 
TELL 
TELL 



'NODE 
'NODE 
'NODE 



USER El 
USER El 
USER El 



13 PASS 'PASS' SET NODE LCS CIR LC-G 

13 PASS 'PASS' LOOP NODE LCS 

13 PASS 'PASS' CLE NODE LCS CIR 

13 PASS 'PASS' SET NODE LC7 CIR LC-7 



1 3 
1 3 



PASS 
PASS 



PASS 
PASS 



LOOP NODE LC7 
CLE NODE LC7 CIR 



13 PASS 'PASS' SET NODE LC8 CIR LC- 

13 PASS 'PASS' LOOP NODE LC8 

13 PASS 'PASS' CLE NODE LC8 CIR 



$ SET NOMERIFY 
$ EXIT 
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As another example, the following shows a portion of an ICP command file for a 
DECnet Router Server system supporting both synchronous and asynchronous lines 
(either CSVRTR16L or CSVRTR32L). The line card in slot 1 has a synchronous line 
and the line card in slot 2 has two asynchronous lines. Therefore, you would enable 
the commands for LC-1, LC-2L, and LC-2R. As shown, the exclamation marks are 
removed from these command lines. 



NCP TELL 'NODE' USER [1,1] PASS 'PASS ' SET NODE LCI CIR LC-1 

L 'NODE ' USER [1,1] PASS 'PASS' LOOP NODE LCI 
NCP TELL 'NODE' USER [1,1] PASS 'PASS' CLE NODE LCI CIR 



$ 


NCP 


$ 


NCP 


$ 


NCP 


$ ! 




* ! 


NCP 


$ ! 


NCP 


$ ! 


NCP 


* ! 




$ ! 


NCP 


$ ! 


NCP 


$ ! 


NCP 


$ ! 




$ ! 


NCP 


$ ! 


NCP 


$ ! 


NCP 


$ ! 




$ 


NCP 


$ 


NCP 


$ 


NCP 


$ ! 




$ 


NCP 


$ 


NCP 


$ 


NCP 



'NODE 
'NODE 
'NODE 



TELL 
TELL 
TELL 



'NODE 
'NODE 
'NODE 



USER [1 
USER CI 
USER [1 

USER [1 
USER [1 
USER [1 

USER [1 
USER [1 
USER [1 



U PASS 'PASS 

U PASS 'PASS 

1] PASS 'PASS 

1] PASS 'PASS 

U PASS 'PASS 

U PASS 'PASS 

1] PASS 'PASS 

U PASS 'PASS 

1] PASS 'PASS 



SET NODE LCI CIR LC-1L 
LOOP NODE LCI 
CLE NODE LCI CIR 

SET NODE LCI CIR LC-1R 
LOOP NODE LCI 
CLE NODE LCI CIR 

SET NODE LC2 CIR LC-2 
LOOP NODE LC2 
CLE NODE LC2 CIR 



USER [1,1] PASS 'PASS ' SET NODE LC2 CIR LC 
USER [1,1] PASS 'PASS' LOOP NODE LC2 

CIR 



L 'NODE 
L 'NODE 

NCP TELL 'NODE' USER [1,1] PASS 'PASS' CLE NODE LC 



:l 



5.2.2 Starting the Procedure 

Start the installation checkout procedure by typing: 
$ @[UIC]filename 

where UIC is the UIC in which you have installed the command file (the UIC for the 
PLUTO account), and filename is one of the following: 

CSVRTRICP 

CSVRTR16L 

CSVRTR32L 
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When you invoke the command file, you will be prompted through the following steps: 

1 You are asked for the server's node name. 

2 You are asked for the server's network privileged password. The command file 
uses this and the node name for accessing the server node to execute the NCP 
LOOP NODE commands. The LOOP NODE commands test the connections to 
the adjacent node on each of the server's point-to-point lines. The loopback tests 
start from the DECnet Router Server. 

The command file sets up a loop node name for each circuit. A loop node name is 

a temporary node name associated with a specific circuit. Section 3.3.2.2 of the 
DECnet Router Software Management Guide further explains how to set up and 
use loop nodes for loopback testing. 

NOTE 

If one or more circuits are inactive, and they should be active, 
then check the router configuration file to see that all circuits are 
set to the ON state. 

If no error messages are reported at your console, then the test succeeded and your 
server software is working properly. If errors are reported, make the necessary correc- 
tions. 

The command file clears all temporary node names that you use during the checkout 
procedure. 

The following is a sample command procedure invoked on VMS host node VMHOST 
to test the five synchronous lines on DECnet Router Server RTRDEV, which is shown 
in Figure 5-7. The arrows in the figure show the flow of test data to each node 
connected by the five lines. 
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$ 0CSURTRICP (RET) 



Please 


ente 


Please 


e n t e 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 






$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


NCP 


TELL 


$ 


EXIT 





the DECnet Rout 
RTRDEM password 



RTRDEV 
RTRDEV 
RTRDEV 



USER CI 
USER CI 
USER CI 



C 1 



C 1 
C 1 



1 1 
1 ] 
1 ] 

1 ] 
1 ] 
1 3 

1 ] 
1 ] 
1 ] 

1 ] 
1 3 
1 ] 

1 ] 
1 ] 
1 ] 



e r Server name; R T R D E V (U) 

: GRANGE© 
PASS ORANGE SET NODE LCI CIR LC-1 
PASS ORANGE LOOP NODE LCI 
PASS ORANGE CLE NODE LCI CIR 

PASS ORANGE SET NODE LC2 CIR LC-2 
PASS ORANGE LOOP NODE LC2 
PASS ORANGE CLE NODE LC2 CIR 

PASS ORANGE SET NODE LC3 CIR LC-3 
PASS ORANGE LOOP NODE LC3 
PASS ORANGE CLE NODE LC3 CIR 

PASS ORANGE SET NODE LC4 CIR LC-4 
PASS ORANGE LOOP NODE LC4 
PASS ORANGE CLE NODE LC4 CIR 

PASS ORANGE SET NODE LC5 CIR LC-5 
PASS ORANGE LOOP NODE LC5 
PASS ORANGE CLE NODE LC5 CIR 

3 PASS ORANGE SET NODE LCB CIR LC-G 

3 PASS ORANGE LOOP NODE LCB 

] PASS ORANGE CLE NODE LCG CIR 

3 PASS ORANGE SET NODE LC7 CIR LC-7 

3 PASS ORANGE LOOP NODE LC7 

3 PASS ORANGE CLE NODE LC7 CIR 

3 PASS ORANGE SET NODE LC8 CIR LC-8 

3 PASS ORANGE LOOP NODE LC8 

3 PASS ORANGE CLE NODE LC8 CIR 
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VMHOST 



□— Ch— Q 



RTRDEV 






LC-5 







TW019 



Figure 5-7: Configuration Tested by Sample ICP 



5.3 Copying Files to Alternate Loading Hosts 

After checking that the software is working properly, copy the software images and 
files from the loading host to all nodes that you wish to use as alternate loading hosts, 
such as the backup hosts. Any backup host can be called upon to down-line load the 
software or receive an up-line dump of server memory. Make sure you copy the files 
into the appropriate place on each host. 

On RSX hosts, the server system image, diagnostics system image, and the loader 
files reside in NETUIC or a special UIC selected for this software. The configuration 
files and ICP command file reside in the PLUTO account, if such an account exists. If 
the PLUTO account does not exist, create it as explained in Section 2.3.2.2. 

On VMS hosts, the server system image, diagnostics system image, and the loader 
files reside in SYS$SYSTEM (SYS$SYSROOT[SYSEXE]). The configuration files 
and the ICP command file reside in the PLUTO account, if such an account exists. If 
the account does not exist, create it as explained in Section 2.2. 
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5.3.1 Copying Files to RSX Alternate Loading Hosts 

To copy files to an alternate RSX loading host node, log in to an account on that host 
and issue the following two Network File Transfer utility (NFT) commands. These 
commands copy the configuration files and ICP command file to the PLUTO direc- 
tory on the alternate loading host. (The PLUTO account must be set up on that host 
first.) 

NFT a^-/iost-id/PLUTO/PLUTO::=/oad/iosf-^/PLUTO/PLUTO::*.CFG 

NFT a^-/iost-id/PLUTO/PLUTO::=load/iost-i'd/PLUTO/PLUTO::CSVRTRICP.CMD 

where 

alt-host-id is the name of the alternate loading host. 
loadhost-id is the name of the loading host. 

After copying the files, edit the network configuration file on each host, as explained 
in Section 5.3.4. Then, use NFT to copy the .SYS files to the NETUIC or special 
server UIC. To find out what the NETUIC is on the alternate host, type: 

SET /NETUIC 

The UIC will be displayed as in the following example: 

NETUIC = [101 ,543 

(If you do not know the NETUIC on the loading host, do the same on the 
loading host.) 

Now use NFT as follows: 

NFT alt-host-id/acc/pass:\[netuic] = loadhost-id/acc/pass::[netuic]*.SYS 

where acc and pass are the respective account and password for each of the hosts. 

Make sure the DECnet database for the server node is set up on each alternate 
loading host. Use the CFE LIST NODE command to display the parameters set for 
the server node. If needed, create on the host a DECnet database for the server node. 
See Section 2.3.2. Also, you need to edit the network configuration file on the host to 
which it is copied, as explained in Section 5.3.4. 

Check the appropriate directories on the alternate loading host to see that the files 
listed in Section 2.3.2.1 have been copied. 
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5.3.2 Copying Files to VMS Alternate Loading Hosts 

To copy files to a VMS alternate loading host, log in to an account on the host node 
and use the COPY command. To load the configuration files, use this command: 

COPY loadhost-id'TLUTO PLUTO"::*.CFG 

The following prompt will then appear: 

To : 

Type the following: 

alt-host-id" priu-acct password": : S YS$S YSROOT: [PLUTO] * 
where 

loadhost-id is the name of the loading host. 

alt-host-id is the name of the alternate host. 

priu-acct is a privileged account on the alternate host, into which files can 

be copied. 

password is the password for the privileged account. 

SYS$SYSROOT: is the default logical name for the device where the files will be 
copied. 

[PLUTO] is the directory on the alternate host, where the files will be 

copied. 

Also, copy CSVRTRICP.COM in the same way. 

NOTE 

The privileged account must be set up on the alternate host before 
copying the files. Make sure the files have world-read access or are 
owned by PLUTO with owner-read access. 

Now, use the COPY command to copy the .SYS files, as follows: 
COPY loadhost-id" acc pass": :SYS$SYSTEM:*.SYS 
The following prompt will appear: 

To : 

Type the following: 

alt-host-id"acc pass ": : S YS$S YSTEM : * 

where acc and pass are the privileged accounts and passwords for the respective hosts. 

NOTE 

Make sure you have the privileges to write in SYS$S YSTEM. 
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Make sure the DECnet database for the server node is set up on each alternate 
loading host. Use the NCP LIST NODE command to display the parameters for the 
server node. If needed, create on the alternate loading host the DECnet database for 
the server node. See Section 2.2. Also, you need to edit the network configuration file 
on the host to which it is copied, as explained in Section 5.3.4. 

Check the appropriate directories on the alternate loading host to see that the files 
listed in Section 2.2 have been copied. 

Instead of using the above method, you can do the following to make a VMS alternate 
host capable of down-line loading the software: VMS software products, including the 
server software, feature kits containing "savesets" as backup copies of the software. 
You can copy a saveset from the primary loading host to an alternate loading host and 
then run VMSINSTAL. Refer to the Guide to Networking on VAX/VMS and the 
Guide to VAX/VMS Software Installation for more details. 



5.3.3 Verifying that All Files Have Been Copied 

Make sure the following files have been copied to each host: 
File Name Directory or account 



PLUT02.SYS 
PLUT03.SYS 
CSVRTR.SYS, 
CSVRTR16L.SYS, 



VMS 

SYS$SYSTEM 
SYS$SYSTEM 
SYS$SYSTEM 



RSX 

NETUIC or special server UIC 
NETUIC or special server UIC 
NETUIC or special server UIC 



CSVRTR32L.SYS 

CSVLDI.SYS 

PLUTOCC.SYS 

PLUTO WL.SYS 

seruer-node-idSB.CFG 

seruer-node-idRTR.CFG 

CSVRTRICP.COM 

CSVRTRICP.CMD 



SYS$SYSTEM 

SYS$SYSTEM 

SYS$SYSTEM 

PLUTO 

PLUTO 

PLUTO 

PLUTO 



NETUIC or special server UIC 

NETUIC or special server UIC 

NETUIC or special server UIC 

PLUTO 

PLUTO 

PLUTO 

PLUTO 



NETUIC is the default. The location of the files depends on what you specify in the down- 
line load database on the host. 
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5.3.4 Editing the Backup Host List 

You need not edit any of the files copied to the alternate loading host nodes. However, 
you can edit the network configuration file at each node to make sure the backup host 
list contains the appropriate number of backup host nodes. On each node, the backup 
host list should be unique. For example, suppose the backup host list on node A 
contains nodes B, C, and D. When you copy files from node A to nodes B, C, and D, 
the backup host lists for each node will be as follows: 

Backup Hosts 

Node A: B, C, D 

Node B: B, C, D 

Node C: B, C, D 

Node D: B, C, D 

On node B, the backup host list includes node B. This means that if node B is called 
on to load the server, the server will have only two nodes available for backups, nodes 
C and D. Therefore, you should substitute another node for node B in the backup list 
on that node, and do similarly for each of the other nodes. For example, after making 
appropriate edits, the backup lists on the nodes could be: 

Backup Hosts 

Node A: B, C, D 

Node B: A, C, D 

Node C: A, B, D 

Node D: A, C, B 

5.4 Editing Configuration Files after Loading 

After installing the DECnet Router Server, you may want to edit the configuration 
files to correct errors you made or to fine tune the routing database. Chapter 4 
explains how to edit these files. After editing the files, load the server again, check out 
the software, and copy the files to backup hosts as done previously. 

5.5 Protecting the Configuration Files 

Once you have successfully installed your server and it is running to your satisfaction, 
you are advised to protect your server configuration files. This will prevent them from 
being changed, deleted, or copied by unauthorized users. Follow the steps described in 
the following sections. To protect the files stored on a VMS loading host, read Section 
5.5.1. To protect the files stored on an RSX loading host, read Section 5.5.2. 
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5.5.1 Protecting Configuration Files on VMS Loading Hosts 

When you install the server, VMSINSTAL sets the DISUSER and CAPTIVE flags to 
protect the PLUTO account. Make sure these flags are not changed. To further 
protect the configuration files, 

1 Set the ownership of the configuration files to that of the PLUTO directory and 
set their protection as read-only by owner. To set the ownership of the configura- 
tion files to the PLUTO directory, type the following command for each file: 

SET FILE/OWNER=[PLUTO] filespec.CFG 

Type the following command to set the protection of the configuration files so that 
the owner has read-only access and all other users are restricted from all types of 
access: 

SET PROTECTION=(OWNER:R,SYSTEM,WORLD,GROUP) filespec.CFG 

2 Set up a log-in command file for the PLUTO account, such as the one shown 
below. The following file insures that only certain nodes can log in to the account. 
Normally, the CAPTIVE and DISUSER flags prevent users from logging in to this 
account. However, network processes such as the File Access Listener (FAL) can 
still access the account. The command file shown here makes sure any access 
requests made by FAL are from a known server. If the request is not from a known 
server, the request is rejected. Specifically, the file senses the name of the remote 

node requesting access, assigning the name to the symbol "remote node". Then 

it checks this name against a list of known server node names. If it finds a match, 
the command file exits to allow the requesting node to continue. If no match is 
found, the file executes the log-out command, thereby denying access to the 

requesting node. In the command file below, replace the "SERVER NODE — N" 

symbols with server node names. You can extend the list if more than three 
servers use the same system as their host. 



File; L0GIN.COM (from PLUTO account) 



$ 
$ 
$ 

$ on error then logout 

$ o n w a r n i n 3 then logout 

$ ! 

$ remote-user = f $ 1 o a i c a 1 ( " s v s $ n e t " ) 

$ n o d e _ 1 e n £ t h = f $ 1 o c a t e ( " : " > r e m o t e _ u s e r ) 

$ r e m o t e _ n o d e = f $ e x t r a c t ( >n o d e _ 1 e n 3 1 h t r e ni o t e _ u s e r ) 

$ ! 

$ if remote-node . e<=i5» "SERVER_N0DE_1" then exit 
$ ! ' " ' s are required 

$ if r eftiote_node »e<=is. " SERVER_N0DE_2 " then exit 
$ ! Include as m a n v seruer nodes as y on ha u e 

$ if remote_node ♦eqs. " SERVER -NODE _X" then exit 

$ loSQLlt 
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3 Write protect the directory in which the configuration files will be stored. This 
prevents anyone from modifying the files or copying new versions of the file into 
the directory. Type the following command: 

SET PROTECTION=(SYSTEM:RED,OWNER:RED,GROUP:RE,WORLD:RE) -dD 

_deu : [dir] PLUTO . DIR (© 

where 

dev. is the device on which the PLUTO directory resides. The default is 
SYS$SYSDEVICE[SYS0]:PLUTO.DIR. 

dir is the directory in which the files will be stored. 

5.5.2 Protecting Configuration Files on RSX Loading Hosts 

On RSX loading hosts, do the following to protect your configuration files: 

1 Use the ACNT program to modify the account for PLUTO. Specifically, set up the 
account as nonprivileged by choosing a group number of 10 or greater (for exam- 
ple, [310,2]). Set up the account as slaved by answering yes to the following 
question: "Slave terminal?". 

2 Create a login.cmd file for the account that prevents users from logging into the 
account. Specify the version number of the file as 77777 (login. cmd;77777). This 
prevents anyone from writing a new version of the file. Within the command file, 
include the following command to log off anyone who tries to log in interactively: 

.XQT BYE 

Using PIP, protect the command file as follows: 
>PI P LOGIN ♦ CMD/PR/WO/GR/OW : R/SY® 

This command restricts all users except the owner from all types of access to the 
file. The owner has read access only. 

3 Set the protection of the files so that the owner has only read-only access and all 
other users are restricted from all types of access. Also, give the files the version 
number of 77777. 

PIP seruer-nodg-idSB.CFG/PR/WO/GR/OW-.R/SY 

PIP sgruer-Mode-idRTR.CFG/PR/WO/GR/OW:R/SY 

PIP server-node-idSB.CFG;imi/RE=server-node-idSB.CFG 

PIP seruer-node-idKTR.CFG;lllll/RE=server-node-idRTR.CFG 

4 Write protect the directory in which the configuration files are to be stored, as 
follows: 

PIP [0,0]rmwwrc.DIR/PR/SY:RWED/OW:R 

where nnnnnn is the UIC, zero-filled. For example, specify the following for UIC 
[310,2]: 

>P I P [ tO ] 3 1 0002 • D I R / PR / S Y : R WED / W = R (RET) 
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Troubleshooting 



This chapter includes troubleshooting procedures for the problems most likely to 
occur when you attempt to load the server software. 

6.1 Server Does Not Load 

Before trying to reload the server, check that the following loading conditions are 
correct. Section 5.1 explains how to set up the proper loading conditions. 

1 Power is on at the server hardware unit. The ON/OFF/LOCK switch must be ON 
and the green POWER light should be ON. 

If the ON/OFF/LOCK switch is ON but the POWER light is OFF, check the 
circuit breaker on the back of the unit. The bar should be up. If it is not, the 
circuit breaker tripped. Reset the breaker and check the POWER light. If the light 
is not ON, check the digital display and other lights on the front panel. If they are 
lit, the POWER light is faulty. Call for service. 

2 Check the UNA lines on all potential loading hosts. The UNA lines must be 
loaded (use the NCP SET LINE UNA-0 ALL command to load the line). 

3 Check the UNA circuits on all potential loading hosts. The circuit state should be 
ON. Also, the circuit should be enabled for service. 

4 Check that event logging is enabled at the loading host and any other potential 
loading host. 

Once all loading conditions are satisfied, try reloading the server. If the reload fails 
(that is, the software does not start running, as indicated by the cyclic pattern on the 
front of the hardware unit), your next step depends on how you tried to start the load. 
If you tried to load the server locally (at the hardware unit), go to Section 6.1.1. If you 
tried to load the server remotely (using NCP LOAD or TRIGGER commands from a 
host), go to Section 6.1.2. 
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6.1.1 Server Cannot Be Loaded Locally 

If you try loading the server by pushing the START button on the hardware unit and 
nothing happens after the initial self-test (the lights blink and the digital display is 
cleared, no "L" indicating the load is taking place), check that: 

1 The down-line load database on the loading hosts are set up properly. If none of 
the potential loading hosts have the database defined for the server, the server's 
request-to-load message sent to the hosts will be left unanswered. 

Type the following NCP command at the host to display the database: 

SHOW NODE server-node-id CHARACTERISTICS 

If the database has not been defined, execute the database command file on the 
loading host. On a VMS host, the file is an NCP command file named seruer- 
node-id.COM. On an RSX host, it is a CFE command file named CFEserver- 
node-id.CMD. You may have installed the server software without executing the 
command file. 

2 The Ethernet hardware address defined in the database is correct. 

3 The system load files are in the correct directory. Also, check that they are world 
readable. 

Also, check for event messages at the loading host. The event messages can point to 
the cause of the problem. 

If all of the above are verified, run LDI to check the hardware components. The 
DECnet Router Software Management Guide explains how to run LDI. Also, see the 
Ethernet Communications Server Operations and Maintenance Manual for complete 
coverage of the hardware diagnostics available. If hardware faults are found, correct 
them or have them corrected, and try to load the server again. 

6.1.2 Server Cannot Be Loaded by Command 

If you cannot get the server to load by using the NCP LOAD command, try using the 
command at another loading host. If the server loads successfully from there, then the 
down-line load database might be set up improperly on the host from which the 
command has failed. Check all the conditions mentioned in Section 6.1.1. Also, check 
that all required files have been installed on the host and that the parameters are 
correct for your installation. (Refer to Chapter 2.) If the files are not correct, correct 
them. Then try loading the server. 

If the server does not load from another loading host, then try the NCP TRIGGER 
command at any DECnet host. If the TRIGGER command works, then the DECnet 
databases on the hosts from which you tried the LOAD command were not set up 
properly. 
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If the TRIGGER command does not get the server to load, then try manual loading. If 
manual loading works, perhaps the server's service password is not correct (that is, 
the service password defined in the DECnet database for the server does not match 
the UNA password defined in the server's network configuration file). 

If manual loading does not work, the reason might be that none of the hosts on the 
Ethernet have the proper DECnet database for loading the server. Another reason 
might be that the down-line load files are in the wrong directory. On VMS hosts, they 
should be in SYS$SYSTEM. On RSX hosts, they should be in NETUIC or whatever 
directory is listed when you issue the following NCP command: 

SHOW NODE server-node-id CHARACTERISTICS 

This command displays the volatile DECnet database parameters used for loading 
the server. If the parameters have not been set up, then shut down the network and 
reload it. 

If necessary, run LDI to check the hardware components. The DECnet Router Soft- 
ware Management Guide explains how to run LDI. Also, see the Ethernet Communi- 
cations Server Operations and Maintenance Manual for complete coverage of the 
hardware diagnostics available. If hardware faults are found, correct them or have 
them corrected, and try to load the server again. 

If the above steps do not isolate the problem source, call for service. 

6.2 Server Loads - LC Circuits Not Turned On 

If after successfully loading the software you notice that the state of the LC circuits is 
OFF (you tried accessing an adjacent node on one of the point-to-point lines and 
access failed, or you typed the NCP SHOW KNOWN CIRCUITS command for exe- 
cution at the server and the display showed the circuit states as OFF), then the 
circuits might still be initializing. Wait a minute or two and see if the circuits turn on. 

If the circuits are still off, check for event messages. They may help you find the cause 
of the problem. 

Possibly, the error lies in the router configuration file. (Event error messages could 
pinpoint the errors.) For example, if the total bandwidth for the circuits is too high 
(the total of the line speeds exceeds the maximum bandwidth shown in Chapter 4), 
the server turns off all the circuits. Or, one of the router initialization files might be 
unreadable. They should have world read access. Use the following commands to 
check that the files are readable: 

From a VMS host: 

TYPE kost-id'TLUTO PLUTO "y.file- id 
From an RSX host: 

NFT Tl:=host-id/PUJTO/PUyTO::file-id 



Troubleshooting 
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6.3 Server Loads - Lines Are On-starting 

If the lines are not on, but are in the on-starting substate, check the following: 

1 The router configuration file parameters. Check in particular that the MAXI- 
MUM ADDRESS is large enough (see Section 4.3). Also, check that the receive 
and transmit passwords are defined properly. On a link that crosses an area 
boundary, make sure that the server and the adjacent node are both level 2 
routers. 

2 Event messages at the loading host or at adjacent hosts trying to access the server. 

3 The fault LED on the line card. This LED should be off. If it is still on, the line 
card might be at fault. Run LDI to be sure. 

4 If LC lines are connected by modem, check that the line parameters defined in the 
router configuration file match the settings for the modem. Test the modem 
hardware. 

6.4 Server Crashes 

If the server crashes, check for event messages at the loading host or a backup host. 
Also, check for a halt code displayed on the hardware unit. Take the appropriate 
corrective action based on the event messages or code. If the problem happens again, 
check for a dump file in the server account on the loading host or backup hosts. Have 
the dump file analyzed by Digital specialists. If you do not find a dump file, force a 
crash dump as explained in the DECnet Router Software Management Guide. 

Try reproducing the problem. Collect more environmental data while doing so by 
answering the following questions. The data can help you or Digital specialists to 
isolate the cause of the problem. 

1 What is the network configuration and what is the application? 

2 What are the version numbers of the affected software? 

3 Describe the problem. 

4 How long has the problem been observed? 

5 What was happening when the problem occurred? 

6 Can you reproduce the problem? 

7 What must you do to reproduce the problem? 

8 What was expected to happen that did not happen? 

9 What event messages did you receive? 

10 What effect does the problem have on the application? 

11 Did the crash result in a dump or did you force a dump? 
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A 

Sample Line Configuration Worksheet 



Figure A-1 shows a sample line configuration worksheet. This worksheet includes 
information used for installing the DECnet Router Server software. It identifies each 
line card and its termination. The worksheet is filled out before installation by the 
system manager (or customer) and Digital software specialists or sales personnel. 

See next page for sample line configuration worksheet. 
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Figure A-1 : Sample Line Configuration Worksheet 



B 

Sample Configuration Files and Procedures 



Section B.l contains an example of a network configuration file. Section B.2 contains 
two examples of prototype router configuration files that can be installed from the 
distribution kit. Chapter 4 explains how to edit these files to customize the configura- 
tion to your needs. Refer to Chapters 3 and 4 for instructions on how to set up the 
server as an area router. Section B.3 contains sample installation, configuration, and 
loading procedures for a DECnet Router Server as performed on a VMS node (Section 
B.3.1) and as performed from an RSX node (Section B.3. 2). Chapter 2 explains how to 
install and load the server. Section B.4 contains sample installation checkout proce- 
dure (ICP) files. 
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B.1 Sample Network Configuration File 



The following is a sample network configuration file for server node RTRDEV. You 
can edit the file by modifying the parameters in each command. 

5 Configuration File - RTRDEUSB.CFG 

5 

5 1* Defining the UNA password (viewed by hosts as the service password)* 

5 Default if invalid or missing: NO PASSWORD SET 

SET LINE UNA-0 PASSWORD FFFF 1 34 

5 

5 2 . Defining the Network Verification password* 

5 Default if invalid or missings NO PASSWORD SET 

SET SYSTEM PASSWORD PRIM 

5 

5 3. Setting the clock frequency to 50 Hz. 
5 Default if invalid or missing; SO Hz. 

SET SYSTEM LINE FREQUENCY BO 

5 

5 4. Backup host node list. 

5 Default: server's maintenance host 

SET EXECUTOR BACKUP HOSTS HOST 1 t H0ST2 > H0ST3 » H0ST4 t HOSTS 

B.2 Sample Router Configuration Files 

Following are examples of prototype (unedited) router configuration files. Section 
B.2.1 contains a file generated for a server software configuration supporting a maxi- 
mum of eight synchronous lines (CSVRTR.SYS). Section B.2. 2 contains a file gener- 
ated for server software supporting a maximum of eight synchronous or 16 asynchro- 
nous lines (CSVRTR16L.SYS). See Chapter 4 for further explanation of the com- 
mands and parameters in the file. 

B.2.1 Unedited Router Configuration File for 8 Synchronous Lines 

The following file accompanies the server software configuration that supports up to 8 
lines, synchronous only. 
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DEC net Router Server Initialization File 
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SET EXECUTOR MAXIMUM BROADCAST ROUTERS 10 

3 ♦ Set the m a x i m u m n u m b e r of n o n r o u t i n g nodes on the Ethernet 
simultaneously* The legal range for the BROADCAST 
NONROUTERS parameter is to 1022 inclusive. The default 
value for this parameter is 32. The number of n o n r o u t e r s 
will be set to the maximum address mi n us one if the n u m b e r 
of n o n r o u t e r s is greater than the maximum address minus 
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SET EXECUTOR MAXIMUM BROADCAST NONROUTERS 32 
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Set the line characteristics (SPEED* DUPLEX > MODEM control 
for each p o i n t - t o - p o i n t connection from the D E C n e t Router 
Server. The options for each parameter are the following: 
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9. Set the circuit characteristics (COST, HELLO TIMER » STATE) 
for the point-to-point circuits from the DEC net Router 
Server* The ledal ranSe for the cost parameter is 1 to 25 
inclusive. This sets the path cost between the DECnet 
Router and the adjacent node on the circuit. The 1 e 3 a 1 
ranse for the HELLO TIMER parameter is 3 to 8191. The 
HELLO TIMER is the rate in seconds that idle transport 
messages are sent to maintain reachability. The options for 

the state parameter are STATE ON or STATE OFF. The default (continued on next page) 
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10. Set the circuit UNA-0 parameters (COST* ROUTING PRIORITY > 
HELLO TIMER). The COST and HELLO TIMER parameters have the 
same attributes and defaults as described above for L C 
circuits. The ROUTING PRIORITY parameter designates which 
router will serve the Ethernet. If two routine nodes have 
the same priority* then the node with the higher node 
address will be the designated router for the Ethernet. 
The legal range for the ROUTING PRIORITY parameter is to 
127 inclusive. The default for this parameter is 100. 



SET CIRCUIT UNA-0 COST 1 ROUTING PRIORITY 100 HELLO TIMER 15 

11, Set the TRANSMIT PASSWORD » which the executor node must 

transmit to an adjacent node during a node initialization 
sequence. The password is one to eight ASCII characters. 
The default for this parameter is no password. 

SET EXECUTOR TRANSMIT PASSWORD DECNET 
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12, Set the RECEIVE PASSWORD t which the executor node expects 
to receive from an adjacent node during a n ode 
initialization sequence. The password is one to eight 
ASCII characters. The default for this parameter is no 
password. 

SET EXECUTOR RECEIVE PASSWORD DECNET 

13, Set the MAXIMUM AREA number in the DECnet network, The 
le^al range for this parameter is 2 to S3 inclusive. If 
this parameter is specified t the DECnet Router will become 
an area router. The default value for the MAXIMUM AREA 
parameter is 1 e u e 1 1 routing only. Refer to the 

doc u m e n t a t i o n when configuring areas. 
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SET EXECUTOR MAXIMUM AREA HOPS 20 
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15* Set the total cost from the DEC net Router Server's area to 
any other reachable area in the network* A remote area is 
unreachable over a path if the cost required to get to it 
exceeds the value set for this parameter* The legal range 
for the AREA COST parameter is 2 to 1022 inclusive* If 
this parameter is specified t the DEC net Router will become 
an area router* The default value for this parameter is 
level 1 routing only. Refer to the documentation w h e n 
configuring areas* 



SET EXECUTOR MAXIMUM AREA COST 1022 
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B.2.2 Unedited File for 8 Synchronous/ 16 Asynchronous Lines 

The following file accompanies the server software configuration supporting up to 8 
synchronous or 16 asynchronous lines. 



Example starts on following page. 
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DEC net Router Server Initialization File 



Copyright (c) 1984 by 

Digital Equipment Corporation* M a y n a r d » Mass. 
File name = "Server's node name "RTR. CFG 



This configuration file resides < 
General D E C n e t account of the dot 
file uses all the default values 
Server node. Note all values are 



in the PLUTO/ PLUTO account or 

■i n - 1 i n e loading host system. This 

for configuring a D E C n e t Router 

in decimal. 



1. Set the MAXIMUM ADDRESS in the DECnet network. The legal 
range for this parameter is 2 to 1023 inclusive. The 
default value for the MAXIMUM ADDRESS parameter is 255. 

SET EXECUTOR MAXIMUM ADDRESS 255 

2 . Set the m a x i m u m n umber of routing nodes ( e x c 1 u ding this 
node) on the Ethernet simultaneously. The legal range for 
the BROADCAST ROUTERS parameter is 1 to 33 inclusive. The 
default value for this parameter is 10. 

SET EXECUTOR MAXIMUM BROADCAST ROUTERS 10 



3 ♦ Set the m a x i m u m n u m b e r of n o n r o u t i n g nodes on the Ethernet 
simultaneously. The legal range for the BROADCAST 
NONROUTERS parameter is 0. to 1022 inclusive. The default 
value for this parameter is 32. The number of nonrouters 
will be set to the maximum address mi n us one if the n u m b e r 
of nonrouters is greater than the maximum address win u s 
one. 

SET EXECUTOR MAXIMUM BROADCAST NONROUTERS 32 
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a, Set the total number of hops from the DECnet Router Server 
to any other reachable node in the network. A remote node 
is unreachable over a path if the number of hops required 
to Set to it exceeds the value set for this parameter* The 
lesal rande for the HOPS parameter is 2 to 30 inclusive. 
The default value for this parameter is 20. 

SET EXECUTOR MAXIMUM HOPS 20 



5 . 



Set the total cost from the DECnet Router Server to any 
other reachable node in the network . A remote node is 
unreachable over a path if the cost required to si el to it 
exceeds the value set for this parameter. The leSal ranSe 
for the COST parameter is 2 to 1022 inclusive. The default 
value for this parameter is 1022. 



SET EXECUTOR MAXIMUM COST 1022 
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SET EXECUTOR BUFFER SIZE 576 



7. Set the SEGMENT BUFFER SIZE. This parameter allows nodes 
with different buffer sizes to communicate efficiently. 
The ledal ranse for the SEGMENT BUFFER SIZE parameter is 
246 to 1466 inclusive. The default value for this 
parameter is 576. 
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SET EXECUTOR SEGMENT BUFFER SIZE 576 
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9. Set the circuit characteristics (COST * HELLO TIMER* STATE) 
for the point-to-point circuits from the DEC net Router 
Server, The 1 e 3 a 1 rantfe for the cost parameter is 1 to 25 
inclusiue . This sets the path cost between the DEC net 
Router and the adjacent node on the circuit* The 1 e 5 a 1 
ranffe for the HELLO TIMER parameter is 3 to 8191, The 
HELLO TIMER is the rate in seconds that idle transport 
messages are sent to maintain reachability. The options for 
the state parameter are STATE ON or STATE OFF. The default 
values for COST* HELLO TIMER and STATE are 1* 15 seconds 
and off respective! y , 
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10. Set the circuit UNA-0 parameters (COST > ROUTING PRIORITY* 
HELLO TIMER). The COST and HELLO TIMER parameters have the 
same attributes and defaults as described above for LC 
circuits. The ROUTING PRIORITY parameter designates which 
router will serve the Ethernet. If two routine nodes have 
the same priority* then the node with the higher node 
address will be the designated router for the Ethernet. 
The letfal ranSe for the ROUTING PRIORITY parameter is to 
127 inclusive. The default for this parameter is 100. 

SET CIRCUIT UNA-0 COST 1 ROUTING PRIORITY 100 HELLO TIMER 15 

11. Set the TRANSMIT PASSWORD > which the executor node must 
transmit to an adjacent node during a node initialization 
sequence. The password is one to eight ASCII characters. 
The default for this parameter is no password. 

SET EXECUTOR TRANSMIT PASSWORD DECNET 



(continued on next page) 
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PASSWORD > w 


h i c h t 


he ex 


e c u 


t 


o r 


n 


ode 


expects 


to receive from 


an adjacent 


n ode 


d u r i n 


3 a 




n o d 


e 






initialization s 


e q u e n c e , T h 


e pass 


w o r d 


i s 





n e 


t 


o e 


i aht 


ASCII characters 


♦ The d e f a u 


It for 


this 


p a 


r 


am e 


t 


e r 


is no 



12, 



password, 

SET EXECUTOR RECEIVE PASSWORD DECNET 
13 . 
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SET EXECUTOR MAXIMUM AREA HOPS 20 
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5 15. Set the total cost from the DEC net Router Server's area to 

5 anv other reachable area in the network* A remote area is 

? unreachable over a path if the cost required to Set to it 

5 exceeds the value set for this parameter* The legal range 

; for the AREA COST parameter is 2 to 1022 inclusive* If 

? this parameter is specified* the DEC net Router will become 

5 an area router* The default value for this parameter is 

? level 1 routing only* Refer to the documentation when 

5 configuring areas. 
5 

5 SET EXECUTOR MAXIMUM AREA COST 1022 



B.3 Examples of DECnet Router Server Installation and Loading 
Procedure 



Section B.3.1 shows a sample installation and loading procedure from a VMS host. 
Section B.3. 2 shows one from an RSX host. 

B.3.1 Installing and Loading Procedure from a VMS Host 

The following is an example showing the installation of software for a DECnet Router 
Server named RTRDEV on a VMS host, VMCENT, followed by an example of the 
down-line loading of the server. First, log into the SYSTEM account and enter the 
following command. Then respond to the questions in the procedure. 



Example starts on following page. 



) 



Sample Configuration Files and Procedures 



B-17 



$ @SYS*UPDATE: VMSINSTAL CSVRTR ti T A : (ret) 

UAX/UMS Software Product Installation Procedure M4.0 
It is 23-AUG-1984 at 1G:19 

Enter a question mark (?) at any time for help. 

XVMSINSTAL-W-DECNET > Your DECnet network is up and running. 

X VMS I NSTAL-W- ACTIVE » The following processes are still active: 

BERGER 

MAIL_71 

_J0B5792 

SMITH 

* Do y o u want to c o n t i n u e a n v way C N ] ? Y (HD 

* Are you satisfied with the backup of your system disk C Y E S 3 ? (ret) 

Please mount the first volume of the set on M T A : * 

* Are you ready? Y © 

AMOUNT- I -MOUNTED * CSVRTR mounted on _ M T A : ♦ 



The foil 


o w i 


n 3 products 


w i 


11 be installe 


d ; 












CSVRTR 


vi 


♦ 1 


















Be 


d i n 


n i n si install 


at 


ion of CSVRTR 


01.1 




a 


t 


IS : 19 




XVMSINSTAL 


_I_ 


RESTORE* Res 


to 


r i n si product s 


a v e s 


e 


t 




A. . ♦ 




Router Ser 


v e r 


V 1 . 1 i n s t a 1 


la 


t i o n procedure 


s ♦ 












The follow 


i n S 


set of ques 


t i 


ons asks y o u f 


or i 


n 


f 


o r m a t i o n u s e d 


t 


set up the 


ac 


c o u n t which 


w i 


11 be used to 


i n s t 


a 


1 


1 


the Router 




Server sof 


twa 


r e . 


















* Device f 


o r 


the account 


CS 


YS$SYSROOT: 3 : 


m 












* UIC for 


ac c 


ount [014*00 


1 3 


: m 














* How ma n v 


s y 


n c h r o n o u s 1 i 


n e 


s will be c o n f 


isur 


e 


d 




( : 1 S ) [83: 




* How m a n y 


as 


y n c h r o n o u s 1 


i n 


e s will be con 


f i si u 


r 


e 


d 


(0:32) [0 3: 




Y o u ha v e c 


h o s 


en 8 s y n c h r o 


n o 


u s a n d a s y n c 


h r o n 





u 


5 


lines* The 


s y s t e m 


conf isurat 


i o n 


that will b 


e 


Generated will 


all 





w 




up to 8 line 


cards 



05 

3 

"D_ 
(D 

O 
O 
=3 
— 

co" 
c 



0) 
Q. 



O 
O 
CD 
Q. 
C 

CD 
0) 



There are 


9 


1 


i n e s per 


a s v 


n c 


hr 


o n 


U 5 


line c a 


r 


d o 


r 1 


1 


i n 


e 




p e 


r synchro n o u s 


line card* 




If 


y o u wish 


t 


a 


dd 


1 


i n e s 


to y o u 


r 


Ro 


u t e r 




at 




5 


o m 


e later time i 


you s h o u 1 d 




r e 


r u n this 


pro 


c e 


du 


r e 


t 


General 


e 


th 


e a p 


p 


r o 


p 


r 


i a 


t e system. 


If there i 


5 


a 


1 ready a n 


ac 


c 


u n 


t 


n a m e 


d PLUTO 


t 


y o 


u w i 


1 


1 


r 


e 


c e 


i m e a 



user 


r e c o 


r d 


s 


uc 


I n s t a 


1 1 i n 


a 


Ro 


ut 


Route 


r Se 


r u 


e r 


g 


The i 


m a & e 


s 


an 


d 


r e s t o 


red 


to 


d 


i s 


set u 


p th 


e 


ho 


St 


This 


c o m m 


an 


d 


p r 


which 


all 


o w 


5 


y o 


to re 


c e i i.i 


e 


an 


u 


crash 


♦ 








This 


p r o c 


ed 


u r 


e 



Thi 


5 


i 


n 


s t 


alia 


t i o n 


c r 


e a t e 


s an a c 


c 


o u n t n a m e d 


1 1 y 


ad 


d 


e 


d 
















m e r 


Ml 




1 


f 


i 1 e s 














les 


i n 


s 


t 


al 


led • 














d fi 


1 e 


s 




of 


the 


Ro u 


t e r 


Se r 


v e r Ml. 


1 


h a u e bee n 


n e x 


t 


s 


t 


e p 


i n 


the 


i n s 


tall 


a t i o n i 


5 


t 



f i 


n 


e s 




the 


data 


bas 


e 


o n 


y o u 


r 


MMS 


h 


5 t 


1 i 


n 


e 


1 


o ad 


the 


s e r 


i.) 


e r 


soft 


w 


are 


an 


d 


p 





f 


t 


h e 


serve 


r fti 


e 


m o r 


y af 


t 


e r a 







execute the NCP command file. 
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: AA-00-03- 
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« Creatine file SYSSSYSROOT : C PLUTO ] RTRDEO * COM 

10 



* Execute File 




( YES 


or NO ) 


[YES] 


: (HIT) 




NOP will print 


u nreco 


£f n 1 Z 6 


U C U III r U 1 1 


trlfi/ t) 1 1 U i d XI 


t h p v*i n H p h p i n d 

U M t? I 1 U U C U Cilia 




defined is not 


a 1 read 


y def 


i n e d i n 


the p e r m a n e n t 


database* You 




may ignore t h e s 


e e r r o 


r s ♦ 










Defining the host dat 


abase 


m ay t a k 


e a n /where f r 


o m a f e w m i n u t e s 




to 30 m i n u t e s d 


e p e n d i 


\i Vi 


c v c + a m 
3 / r> 1/ t: ill 


1 n a d z\ \"t ri c i t p 


n*f t h p hnc:t'c: 




node database* 














XNCP- I -NMLRSP » 


listen 


e r re 


s p o n s e - 


Unrecognized 


component* Node 




ZNCP- I -NMLRSP t 


listen 


e r re 


s p o n s e - 


Unrecognized 


component* Node 




This procedure 


will n 


o w c r 


e at e the 


D E C n e t Route 


r Server network 




configuration f 


i 1 e ♦ 












The network confisfura 


t i o n 


file w i 1 


1 be named RTRDEUSB » CFG » 
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9L When the procedure is complete* check and edit (if necessary) the 

g. router configuration file ( RTRDEORTR . CFG ) * 

§ OMSINSTAL- I -MOVEFILES > Files will now be moved to their target directories 

O Successful install at ion of CSORTR 01*1 at 16:25 

~ OMSINSTAL procedure done at 16:35 



Created the configuration file SYS$SYSROOT :C PLUTO ] RTRDEOSB , CFG 



Assuming you are using the predefined DECnet Router Server configuration file, you 
are now ready to load the DECnet Router Server. Before using the NCP LOAD 
command, you must prepare the UNA-0 line and circuit for down-line loading, as 
shown: 

$ NCP> SET LINE UNA-0 ALL (ret) 

$ NCP> SET CIRCUIT UNA-0 SERVICE ENABLED STATE ON© 
* NCP> LOAD NODE RTRDEV © 

The following events are seen at the logging console or logging monitor of the loading 
host: 

"I "/,, 7. "/„ "1 1 7, 7, 7, "/., 7, OPCOM 26-AUG-84 14:22:10.76 
Message from user DECnet on U M C E N T 
DECnet event 0.3, automatic line service 
From node 120 (OMCENT) , 26-AUG-84 14:22:03.86 
Circuit UNA-0* Load* Requested* Node = 134 (RTRDEM) 
File = PLUT02.SYS > Secondary loader 

Tm:y:i:r/:rn:i opcom 2g-aug-84 i4:22:io.85 

Message from user DECnet on V M C E N T 
DECnet event 0.3 , automatic line service 
From node 120 (OMCENT), 26-AUG-84 14:22:10.66 
Circuit UNA-0, Load, Successful, Node = 134 (RTRDEV) 
File = PLUT02.SYS , Secondary loader 

%ZVrUJ,r/.J.J.r/, OPCOM 2G-AUG-84 14:22: 1 1.32 
Message from user DECnet on U M C E N T 
DECnet event 0.3, automatic line service 
From node 120 (OMCENT), 26-AUG-84 14:22:11,06 
Circuit UNA-0, Load, Requested, Node = 134 (RTRDEM) 
File = PLUT03.SYS, Tertiary loader 

y./urn,rnrnrn. opcom 26-aug-84 14:22:1 1.76 

Message from user DECnet on l , J M C E N T 
DECnet event 0.3, automatic line service 
From node 120 (OMCENT), 26-AUG-84 14:22:11.66 
Circuit UNA-0, Load, Successful, Node = 134 (RTRDEM5 
File = PLUT03.SYS, Tertiary loader 

zii7,r/,ruru,'u. opcom 2g-aug-84 14:22:12.03 

Message from user DECnet on M M C E N T 
DECnet event 0.3, automatic line service 
From node 120 (UMCENT), 26- AUG- 84 14:22:11.78 
Circuit UNA-0, Load, Requested, Node = 134 (RTRDEU) 
File = CSMRTR.SYS, Operating system 

ZZ17,J.rrUJ.ril OPCOM 2S-AUG-84 14: 22:1 3.06 
Message from user DECnet on V M C E N T 
DECnet event 0.3, automatic line service 
From node 120 (MMCENT), 26-AUG-84 14:23:10.76 
Circuit UNA-0, Load, Successful, Node = 134 (RTRDEV) 
File = CSURTR.SYS, Operating system 
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D E C n e t event 225.0 

From node 134 (RTRDEV)* 2G-AUG-84 14:24:21.37 
Parameter #0 = Server initializing* 
Identification = D E C n e t Router Server V 1 . 1 8 L 

D E Cn e t event 4 ♦ 1 5 > adjacency up 

From node 120 (VMCENT) * 2G-AUG-84 14:25:00. S3 
Circuit UNA-O* Adjacent node = 134 (RTRDEV) 

D E C n e t event 4 , 1 5 * adjacency up 

From node 134 (RTRDEV) * 2B-AUG-84 14:25:10,58 
Circuit UNA-O* Adjacent node = 245 (HOST A) 

D E C n e t event 4.15* adjacency up 

From node 134 (RTRDEV)* 2S-AUG-84 14:28:00.80 
Circuit UNA-0 * Adjacent node = 450 (HOSTB) 



D E C n e t event 4 . 1 5 * adjacency up 

From node 134 (RTRDEV)* 2B-AUG-84 14:28:50.78 
Circuit UNA-O* Adjacent node = 124 (HOSTC) 

D E C n e t event 4.10* circuit up 

From node 134 (RTRDEV)* 2B-AUG-84 14:28:53.44 

Circuit LC-1* Adjacent node = 211 (HELTER) 

D E C n e t event 4.10* circuit up 

From node 134 (RTRDEV)* 2B-AUG-84 14:28:58.78 

Circuit LC-2* Adjacent node = 418 (MELTER) 



DECnet event 228.0 

From node 134 (RTRDEV)* 28-AUG-84 14:28:59.18 

Server up* Identification = DECnet Router Server VI* 1 8L 
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B.3.2 Installing and Loading Procedure from an RSX Host 

The following commands unload the server files from an RL02 distribution disk to the 
loading host RSXCEN. 

>MOU DL1 rCSVRTR© 

>pip /nv = dli : i no taoi*.*m 

After the files are copied, the installer performs RSXINSTAL: 



Example starts on following page. 



) 
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n >set /uic = cao tao]© 

10 >ASN DLi : = SY : © 

*" >@RS>< INSTALL 



JJ 
O 
c 

r—t- 

CD 
— * 

to 

o 

— H 
#— 

$ 

03 



5 D E C n e t Router Server Installation Procedure 
> Started at 13:08:34 on 03 -AUG -84 



5 Copyright (C) 1384 by 

5 Digital Equipment Corporation t M a y n a r d » Mass* 





> 5 T h 


is installation 


procedure 


install 


s th 




> 5 o n 


a RSX-11M/M+ ho 


st. This 


p r o c e d u r 


e m u 




> 5 a c 

> 5 


c o u n t * 










> ? Th 


is procedure w i 1 


1 create 


and cop y 


s e r 




> 5 n e 


two rK c o n f i & u r a t 


ion file 


based o n 


the 


a 


> 5 A 


file named C F E < n 


ode > . CMD 


will co n 


tain 


m 


> 5 p e 


r m anient database 


on this 


host. 




o 


> 5 










rj 












CD 


> 5 Y o 


u m a y type an e s 


cape <ESC 


> at an y 


q u e 



> 5 information about the question, 

> ? 

> 5 < E S > Do y o u w ant to: 

> * < R E T > - C o n t i n u e t E - E x i t E S ] : (H) 



i Section 1 - General information 



■Er > 5 Now y o u m ust decide where you would 1 i K e to put the Marions DEC n e t 

£. > 5 Router Seruer files. It is suggested that you pick one u i c for the 

O > ; configuration f i 1 e s t one uic for the loaders and system images and one 

_ >5 uic for the d u iiip images. 
Q 

E ' : ' ' 

q! > 5 NOTE: The uic where the configuration files reside must haue a user id 

>5 and password of PLUTO/PLUTO. (continued on next page) 



cn 
3 

"D 
CD 

o 

O 
^» 

cq" 
c 



CD 
0) 

so 

Q. 



O 
O 
CD 
Q_ 
C 
~ r 
CD 
to 



When answering questions in this section please type the full 
directory specification. ( D E U : C n n n > n n n ] ) 



1 * 
1,01 
1 , 02 
1 . 03 

<eos: 



Where will configuration files reside CS D : " SY : C 40 > 40 ] " ] : (H) 
Where will system files reside CS D : " SY : C 40 » 40 ] " ] : DL0 : C 1 00 t 54 ] (ret) 
Where will dump files reside CS D : " DLO : C 1 00 1 54 ] " ] : (RET) 
Do you need to run the account program? C Y / N ] : (RET) 



Do y o u 
< RET > 



w ant to: 

Continue t R - R e p e a t 



section* E-Exit CS] 



Section 2 



> u i 1 d i n g the network configu ratio n 



* 2,0 H o w (it a n v s v 


n c h r o n 


o u s 1 i n e 


s will be c o n f i 


Sure d 


( : 1 G ) 


C8] : 


m 


* 2,01 How m a n y a s 


y n c h r o 


n oils 1 i n 


e s will be c o n f 


i g u r e 


d (0:32) 


CO] 


: m 


i 

5 You h a u e chose n 


8 s y n c 


h r o n o u s 


and asynchron 


ous 1 


i n e s . T h 


e s y 


stem 


5 configuration t h 


at w i 1 


1 be gen 


erated will all 


W U P 


t o 8 1 i 


n e c 


a r d s ♦ 


5 NO ASYNCHRONOUS 
5 


LINES 


WILL BE 


GENERATED* 










5 

? There ' are 2 line 


s per 


a s y n c h r o 


n oils line card 


or 1 


line per 


s y n 


c h r o n o u s 


5 line card* If y o 


u wish 


to add 


lines to your R 


outer 


at some 


1 at 


e r time t 


5 y oil should r e r u n 


this 


p r o c e d u r 


e to generate t 


he ap 


propriat 


e s y 


stem* 



CD 

I 

N> 

cn 



# 


n 


02 


What 


is the 


n o d e - 


i d 





f 


th 


e server 


CS] : 


R T R D E U (RET) 




* 


Z * 


03 


What 


is the 


n o d e - 


ad 


d r 


e 


5 S 


CD R : 1 * - 1 


023. 


] : 134(REI 




# 


*7 


04 


What 


is the 


UNA-0 


p 


as 


5 


wo r 


d C S R : 1 . 


-16, 


D:"0"]: FFFF134dl) 




# 




05 


What 


is the 


n e t w o 


rk 


p 


r 


i u i 


leged pas 


s w o r 


d CS R:0,-8. ] : PRIM 


m 


* 

5 




OS 


What 


is the 


s y s t e 


m 


1 i 


n 


e c 


lock f req 


u e n c 


y CD R:50.-B0. D:G0 


, ] : (ret) 


5 


If 


V 


u w a n 


t more 


than 


o n 


e 


b 


ac k 


up host e 


n t e r 


them separated by 


c o m m a s 


? 


i ♦ 


e * 


HOST 1 


>H0ST2 


>H0ST3 



















(continued on next page) 



00 

I 

ro 



D 

m 
O 

CD 

3J 
O 
c 



CO 

o 

I— 

0) 



3 
CO 

#— ♦- 

SB 
o' 

Q 
c 

CD 



* 2.07 


Wh 


at are 


the 


n 





d e - i d ' s of 


t 


he back 


UP 


h 


5 


t 5 




CS3 : (He) 






5 Back 


U P 


hosts 


are n 


e 


e 


d e d w hen t h 


e 


server 


' 5 


m 


a i 


n t 


e 


nance ho 


s 


t is out 


? of s 


e r u 


ice* A 


DECn 


e 


t 


Router Ser 


M 


e r ma v 


n e e 


d 


t 





1 


oa an e u 


e 


n t or 


5 up-1 


i n e 


d u m p 


a sys 


t 


e 


m i m a si e . If 




the inai 


n t e 


n 


an 


c e 




host is 


d 


own * a 


5 back 


U P 


host i 


s nee 


d 


e 


d to assist 




the DEC 


n e t 




Ro 


Lit 


e 


r Be r u e r 




Be sure 


5 t 5 


et 


up the 


s e r u 


e 


r 


databases 





n the b 


ac k 


u 


p 


h o 


s 


t s . Ente 


r 


the 


5 back 


UP 


hosts 


as a 


1 


i 


st. The max 


i 


m u m i s 


f iu 


e 


b 


ac 


k 


up hosts 




For 


5 exam 


pie 

































HOST 1 *H0ST2 >H0ST3 »H0ST4 *H0ST5 
2.07 Nhat are the node-id's of the backup hosts [S3; SHIM * C E N T R > A L E (RET) 



• u i 1 d i n 3 the network configuration file. 
(SY: [40 * 4 ] R T R D E S B ♦ C F G ) 



NOTE; You must also tailor the router configuration file in 

dev :[nnn,nnn]RT RDEVRT R * CFG after this procedure 

completes. 

<RET>-Continue * R-Repeat section* E-Exit LSI: fH) 



Section 3 



M o m i n sf the D E C n e t Router Seruer files. 



Copying loaders and system files to DL0:C 100*54] 

Copying configuration files 
RTRDEUSB.CFG and RTR.CFG 
to SY; [40*40] 



(continued on next page) 



0) 
Q> 

3 

CD 

o 
o 

— K 

cq' 
c 



o 
2) 

CD 
0) 

0) 
Q. 



O 
O 
CD 
Q. 
C 

CD 
0) 



i Section 4 



• li i 1 d i n £ the down-line load database 



•* £1*00 What is the loading host's service circuit-id CS D : " UN A - " ] : (ret) 
•* 4,01 What is the server's hardware address LSI: AA-00-03-00-00-86(H) 



You can define these node characteristics in the host's permanent 
database by r u nnins C F E with the c o m wand file built in this 
procedure ( DLO : C 1 00 t 54 ] CFERTRDEU . CMD ) » as follows: 



INS DEM: [NETUICICFE.TSK 
>CFE 



E n t e 


r f i 


le 


n 


am 


CFE> 


8 D L 


: [ 


1 





CFE) 


s h 


n o 


d 


e 






D 


i 


S P 


CFE> 


£. 









E □ S > Do y o u w ant to: 

R-Repeat section* E or < R E T > - E x i t CS]: (E) 



Remember to: 



1 . E d i 


t 


y our r o 


Lit 


e r configuration file 




2, Upd 


at 


e y o u r 


p e 


r in a n e n t database with 


the newly created C F E comma n d 


f i 1 


e ♦ 


The n e 


xt 


time y o u r network is 


loaded > the volatile database 


on 


th 


e host 


w i 


11 be set up. 





I 

ro 

(continued on next page) 



3. 



If your volatile database is set iipi then you may trid^er or 
load the seruer, If the volatile database is not set u p » then 
down-line load your server with the full N C P com m a n d : 



NCP LOAD NODE RTRDEU FROM DLO : C 1 00 , 54 1 CSMRTR ♦ SYS SER PASS PRIM 

4 ♦ If you change the synchronous/asynchronous line conf isuratio n * 
you should rerun this procedure to ensure you have the correct 
software imaSe generated for the new configuration* 



D E C n e t Router Server Installation Procedure 
Stopped at 13:11:03 on 03-AUG-84 



•@ <EOF> 



Assuming you are using the predefined DECnet Router Server configuration file, you 
are now ready to load the DECnet Router Server. Before using the NCP LOAD 
command, you must prepare the UNA-0 line and circuit for down-line loading, as 
shown: 

$ NCP> SET LINE UNA-0 ALL m 

$ NCP> SET CIRCUIT UNA-0 SERVICE ENABLED STATE ON© 
$ NCP> LOAD NODE RTRDEU d?) 

The following are events normally seen on an RSX loading host. The loading host is 
RSXCEN: 



E v e n t type ♦ 3 » Automatic seruioe 
Occurred 26-AUG-84 16:41:04 or. node 245 (RSXCEN) 
Circuit UNA-0 
Service type = Load 
Status = Requested 

Node = 134 (RTRDEV), File = DLO : C 1 00 » 54 3 PLUT02 . SYS 
Software type = Secondary loader 

Event type ♦ 3 t Automatic service 
Occurred 2G-AUG-84 1G:41:04 on node 245 (RSXCEN) 
Circuit UNA-0 
Service type = Load 
Status = Successful 

Node = 134 (RTRDEV), File = DLO : C 1 00 t 54 3 PLUT02 . SYS 
Software type = Secondary loader 

Event type 0.3* Automatic service 
Occurred 2B-AUG-84 16:41:05 on node 245 (RSXCEN) 
Circuit UNA-0 
Service type = Load 
Status = Requested 

Node = 134 ( R T R D E ) t File = DLO : C 1 00 » 54 3 PLUT03 . SYS 
Software type = Tertiary loader 

Event type 0.3* Automatic service 
Occurred 26-AUG-S4 16:41:06 on node 245 (RSXCEN) 
Circuit UNA-0 
Service type = Load 
Status = Successful 

Node = 134 (RTRDEV), File = DLO : C 1 00 »54 3 PLUT03 . SYS 
Software type = Tertiary loader 

Event type ♦ 3 » Automatic service 
Occurred 26-AUG-84 16:41:07 on node 245 (RSXCEN) 
Circuit UNA-0 
Service type = Load 
Status = Requested 

Node = 134 (RTRDEV), File = DLO : C 1 00 t 54 3 CSMRTR ♦ SYS 
Software type = System 



(continued on next page) 
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E v e n t 


type ♦ 3 t Auto 


(ii a t i c service 






Ocourre 


d 2B-AUG-84 IB 


: 4 2 ; 4 


on 


n ode 


245 


(RSXCEN) 


Circuit 


UNA-0 












Service 


type = Load 












Status 


= Successful 












Node = 


134 ( R T R D E U ) t 


File = 


DLO 


: C 100 


»54HCSURTR.SYS 


S o f t w a r 


e type = S y s t e 












E v e n t 


type 225*0 












Ocourre 


d 2B-AUG-84 IS 


: 4 3 : 


on 


n ode 


134 


(RTRDEU) 


Server 


initializing t 


I d e n t i f 


i c a t i o n 


= D E C n e t Router 


E v e n t 


type 4.15t Ad J 


a c e n c v 


u P 








Ocourre 


d 2B-AUG-84 IB 


: 4 3 : B 


o n 


n ode 


245 


( RSXCEN ) 


Circuit 


UNA-0 












A d J a c e n 


t node = 134 ( 


RTRDEU ) 










E v e n t 


type 4 ♦ 1 5 t Add 


a c e n c y 


U P 








Ocourre 


d 2B-AUG-84 16 


; 4 3 : 8 


o n 


n ode 


134 


( RTRDEU ) 


Circuit 


UNA-0 












A d j a c e n 


t node = 245 












E v e n t 


type 4 ♦ 1 5 > Ad j 


a c e n c y 


U P 








Qccurre 


d 2B-AUG-84 IS 


: 43 :54 


on 


n ode 


134 


< RTRDEU ) 


Circuit 


UNA-0 












A d J a c e n 


t node = SHIM 













E 


u 


en t 


Dc 


c 


u r r e 


Ci 


r 


c u i t 


Ad 


J 


acen 


E 


v 


en t 


□ c 


c 


urre 


Ci 


r 


c u i t 


No 


d 


e ad 


E 


v 


en t 


□ c 


c 


urre 


Ci 


r 


c u i t 


No 


d 


e ad 



211 (HELTER) 



418 (MELTER) 



E 


i.j 


e n t 


type 


22B ♦ 




Oc 


c 


urre 


d 2B 


-AUG-84 


1S;45s21 


Se 


r 


v e r 


UP > 


I d e n t i f 


ioat ion = 



on node 134 (RTRDEU) 

D E C n e t Router Server U 1 ♦ 1 8 L 
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B.4 Sample Installation Checkout Procedures 



Section B.4.1 contains a sample installation checkout procedure done on VMS hosts. 
Section B.4. 2 contains a sample procedure done on RSX hosts. Both procedures 
assume a fully configured server for eight synchronous lines. If you have fewer lines, 
disable command lines that test the unused LCs. On VMS hosts, precede such com- 
mand lines with an exclamation mark (!). On RSX hosts, precede them with a 
semicolon (;). (This turns the command lines into comments.) 

Section B.4. 3 contains a sample procedure done on a VMS host to test a DECnet 
Router Server with both synchronous and asynchronous lines. 



B.4.1 Sample VMS Installation Checkout Procedure 



Following is a sample installation checkout procedure used on a VMS host to test 
eight circuits on RTRDEV. RTRDEV's system image is CSVRTR.SYS, which sup- 
ports synchronous lines only. 

$ eCSVRTRICP© 

PI 
PI 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
$ 
* 
$ 
$ 
$ 
* 



ease 


enter the DECnet 


Router Server name: 


RTRDEV (ret) 






ease 


enter R T R D E V password 


PR T u 


IOELU 














WPP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


SET 


NODE 


LCI 


CIR 


LC 


_ i 


NCP 




l\ I lA U C V 




r i 

L 1 


. 1 1 


PASS 


PR IV 


LOOP 


NODE 


LCI 








NCP 


TFI I 

I C L. L_ 


I \ i n u c v 


I I^FR 

w O C I \ 


r i 


t 1 ] 


DACC 
r H D D 


r IT 1 V 


n F 

LLL 


KinnF 


i r 1 

L_ 1 


CIR 






M P P 


TELL 


RTRDEV 


USER 


[ 1 


t 1 ] 


DAQC 
rnDo 


DP T II 


CCT 

O t 1 


1 N u u c 


l_ Li i- 


r t p 

L/ 1 IT 


LC 




m r p 

IN U r 


TELL 


RTRDEV 


USER 


C 1 


t 1 ] 


PASS 


PR IV 


LOOP 


NODE 


LC2 








NCP 


TELL 


RTRDEV 


USER 


C 1 


»1 ] 


PASS 


PR IV 


CLE 


NODE 


LC2 


CIR 






NCP 


TELL 


RTRDEV 


USER 


C 1 


» 1 ] 


PASS 


PR IV 


SET 


NODE 


LC3 


CIR 


LC 


-3 


NCP 


TELL 


RTRDEV 


USER 


[ 1 


»1 ] 


PASS 


PR IV 


LOOP 


NODE 


LC3 








NCP 


TELL 


RTRDEV 


USER 


C 1 


t 1 ] 


PASS 


PR IV 


CLE 


NODE 


LC3 


CIR 






NCP 


TELL 


RTRDEV 


USER 


C 1 


»1 ] 


PASS 


PR IV 


SET 


NODE 


LC4 


CIR 


LC 


-a 


NCP 


TELL 


RTRDEV 


USER 


[ 1 


»1 ] 


PASS 


PR IV 


LOOP 


NODE 


LC4 








NCP 


TELL 


RTRDEV 


USER 


C 1 


»1 1 


PASS 


PR IV 


CLE 


NODE 


LC4 


CIR 






NCP 


TELL 


RTRDEV 


USER 


[ 1 


1 1 ] 


PASS 


PR IV 


SET 


NODE 


LCS 


CIR 


LC 


-5 


NCP 


TELL 


RTRDEV 


USER 


C 1 


tl 3 


PASS 


PR IV 


LOOP 


NODE 


LCS 








NCP 


TELL 


RTRDEV 


USER 


[ 1 


> 1 ] 


PASS 


PR IV 


CLE 


NODE 


LCS 


CIR 






NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


SET 


NODE 


lcb 


CIR 


LC 


- 6 


NCP 


TELL 


RTRDEV 


USER 


1 1 


1 1 ] 


PASS 


PR IV 


LOOP 


NODE 


LCS 








NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


CLE 


NODE 


LCS 


CIR 






NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


SET 


NODE 


LC7 


CIR 


LC 


-7 


NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


LOOP 


NODE 


LC7 








NCP 


TELL 


RTRDEV 


USER 


[ 1 


til 


PASS 


PR IV 


NODE 


LC7 


CIR 








NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


SET 


NODE 


LC8 


CIR 


LC 


-8 


NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


LOOP 


NODE 


LC8 








NCP 


TELL 


RTRDEV 


USER 


C 1 


til 


PASS 


PR IV 


CLE 


NODE 


LC8 


CIR 







EXIT 
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B.4.2 Sample RSX Installation Checkout Procedure 

The following is a sample installation checkout procedure used on an RSX host to 
check the eight circuits on RTRDEV. RTRDEV's system image is CSVRTR.SYS, 
which supports synchronous lines only. 

>@CSMRTRICP 

>* Please enter the DECnet Router Server name C S ] : RTRDEV® 



> * Please 


enter 


RTRDE', 


password 


C S ] : 


PRIM© 






> N C P 


TELL 


RTRDE' 


1 PASS 


PRIM 


SET 


NODE 


LCI 


C I R 


LC- 


1 


> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


LOOP 


NODE 


LCI 








> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


CLE 


NODE 


LCI 


C I R 






>IMCP 


TELL 


RTRDE' 


' PASS 


PRIM 


SET 


NODE 


LC2 


C IR 


LC- 




> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


LOOP 


NODE 


LC2 








> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


CLE 


NODE 


LC2 


CIR 






> N C P 


TELL 


RTRDE', 


' PASS 


PRIM 


SET 


NODE 


LC3 


C I R 


LC- 


3 


> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


LOOP 


NODE 


LC3 








> N C P 


TELL 


n t n n i — i 

R T R D E ', 


' PASS 


PRIM 


CLE 


NODE 


LC3 


CIR 






> N C P 


TELL 


RTRDE' 


' PASS 


PRIM 


SET 


NODE 


LC4 


CIR 


LC - 


IX 


> N C P 


TELL 


i~i t r~i r\ r*" i 

R T R D E l . 


' PASS 


PRIM 


LOOP 


NODE 


LC4 








>NCP 


TELL 


n t n n r i 

RTRDE' 


' PASS 


PR I M 


CLE 


NODE 


Lea 


CIR 






>NCP 


TELL 


RTRDE', 


1 PASS 


PRIM 


SET 


NODE 


LC5 


CIR 


LC- 


5 


>NCP 


TELL 


RTRDE 1 


' PASS 


PRIM 


LOOP 


NODE 


LC5 








>NCP 


TELL 


RTRDEV 


> PASS 


PRIM 


CLE 


NODE 


LC5 


CIR 






>NCP 


TELL 


RTRDE* 


' PASS 


PRIM 


SET 


NODE 


LCS 


CIR 


LC- 


6 


>NCP 


TELL 


RTRDE 1 , 


' PASS 


PRIM 


LOOP 


NODE 


LCB 








>NCP 


TELL 


RTRDE' 


' PASS 


PRIM 


CLE 


NODE 


LCS 


CIR 






>NCP 


TELL 


RTRDEV 


' PASS 


PRIM 


SET 


NODE 


LC7 


CIR 


LC- 


7 


>NCP 


TELL 


RTRDE* 


' PASS 


PRIM 


LOOP 


NODE 


LC7 








>NCP 


TELL 


RTRDE*, 


' PASS 


PRIM 


CLE 


NODE 


LC7 


CIR 






>NCP 


TELL 


RTRDE', 


) PASS 


PRIM 


SET 


NODE 


LC8 


CIR 


LC- 


8 


>NCP 


TELL 


RTRDE' 


' PASS 


PRIM 


LOOP 


NODE 


LC8 








>NCP 


TELL 


RTRDE', 


' PASS 


PRIM 




NODE 


LC8 


CIR 






@ <EOF> 
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B.4.3 Sample for Synchronous/Asynchronous Line Configuration 

The following is a sample installation checkout procedure run on a VMS host to check 
the lines on a server with both synchronous and asynchronous lines. The server being 
checked, node RTR16L, has software that supports the 16-line maximum 
(CSVRTR16L.SYS). RTR16L has one synchronous line in line card slot 1. The re- 
maining seven slots contain two asynchronous lines each. 



$ SCSVRTRIBL© 



NCP 


TELL 


RTR1GL 


USER 


[ 1 


, 1 ] 


PASS 


PR IV 


SET NODE LCI 


CIR 


LC- 


1L 


NCP 


TELL 


RTR1GL 


USER 


C 1 


,1 ] 


PASS 


PRIM 


LOOP NODE LCI 








NCP 


TELL 


RTR1SL 


USER 


E 1 


* 1 ] 


PASS 


PR IV 


CLE NODE LCI 


CIR 






NCP 


TELL 


RTR1BL 


USER 


C 1 


, 1 3 


PASS 


PRIM 


SET NODE LCI 


CIR 


LC- 


1R 


NCP 


TELL 


RTR1GL 


USER 


C 1 


, i ] 


PASS 


PRIM 


LOOP NODE LCI 








NCP 


TELL 


RTR1BL 


USER 


[ 1 


, l : 


PASS 


PRIM 


CLE NODE LCI 


CIR 






NCP 


TELL 


RTR1GL 


USER 


[ 1 


, 1 ] 


PASS 


PRIM 


,SET NODE LC2 


CIR 


LC- 




NCP 


TELL 


RTR1GL 


USER 


[ 1 


,1 3 


PASS 


PRIM 


LOOP NODE LC2 








NCP 


TELL 


RTR16L 


USER 


C 1 


, 1 ] 


PASS 


PRIM 


CLE NODE LC2 


CIR 






NCP 


TELL 


RTR1GL 


USER [ 


1 , 


1 ] 


PASS 


PRIM 


SET NODE LC2 CIR 


LC-2 


L 



Please 
Please 
$ NCP 
$ NCP 
$ NCP 
$ 
$ 
$ 
$ 
$ 
$ 
$ 



enter the D E C n e t 
enter RTR16L pas 
TELL RTR16L USER 
TELL RTR1GL USER 
TELL RTR1SL USER 



Router Server name 
sword: PRIM© 
E 1 , 1 ] PASS PRIM 
El ,13 PASS PRIM 
[1*1] PASS PRIM 



RTRlGLdU 



SET NODE LCI CIR 
LOOP NODE LCI 
CLE NODE LCI CIR 



LC- 1 



NCP TELL RTR16L USER El, 13 PASS PRIM LOOP NODE LC2 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC2 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC2 CIR LC-2R 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC2 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC2 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC3 CIR LC-3 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC3 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC3 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC3 CIR LC-3L 
NCP TELL RTR1GL USER El ,13 PASS PRIM LOOP NODE LC3 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC3 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC3 CIR LC-3R 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC3 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC3 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC4 CIR LC-4 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC4 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC4 CIR 
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$ NCP TELL RTR1BL USER El, 13 PASS PRIM SET NODE LC4 CIR LC-4L 

$ NCP TELL RTR1SL USER [1,13 PASS PRIM LOOP NODE LC4 

$ NCP TELL RTR1SL USER [1*13 PASS PRIM CLE NODE LC4 CIR 

$ 

$ NCP TELL RTR1BL USER El, 13 PASS PRIM SET NODE LC4 CIR LC-4R 

* NCP TELL RTR1SL USER El, 13 PASS PRIM LOOP NODE LC4 

$ NCP TELL RTR1SL USER C 1 * 1 3 PASS PRIM CLE NODE LC4 CIR 



NCP TELL RTR1BL USER C 1 t 1 3 PASS PRIM SET NODE LC5 CIR LC-5 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC5 
NCP TELL RTR1SL USER E 1 , 1 3 PASS PRIM CLE NODE LC5 CIR 

NCP TELL RTR1SL USER El, 13 PASS PRIM SET NODE LC5 CIR LC-5L 
NCP TELL RTR1GL USER El ,13 PASS PRIM LOOP NODE LC5 
NCP TELL RTR1BL USER [1,13 PASS PRIM CLE NODE LC5 CIR 

NCP TELL RTR1GL USER El ,13 PASS PRIM SET NODE LC5 CIR LC-5R 
NCP TELL RTR1BL USER El ,13 PASS PRIM LOOP NODE LC5 
NCP TELL RTR1BL USER [1,13 PASS PRIM CLE NODE LC5 CIR 

NCP TELL RTR1SL USER El ,13 PASS PRIM SET NODE LCG CIR LC-B 
NCP TELL RTR1BL USER El, 13 PASS PRIM LOOP NODE LCS 
NCP TELL RTR1BL USER El ,13 PASS PRIM CLE NODE LCB CIR 

NCP TELL RTR1BL USER El, 13 PASS PRIM SET NODE LCG CIR LC-SL 
NCP TELL RTR1BL USER El, 13 PASS PRIM LOOP NODE LCG 
NCP TELL RTR1GL USER [1,13 PASS PRIM CLE NODE LCG CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LCG CIR LC-BR 
NCP TELL RTR1BL USER El, 13 PASS PRIM LOOP NODE LCG 
NCP TELL RTR1GL USER [1,13 PASS PRIM CLE NODE LCG CIR 

NCP TELL RTR1GL USER [1,13 PASS PRIM SET NODE LC7 CIR LC-7 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC7 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC7 CIR 

NCP TELL RTR1BL USER El, 13 PASS PRIM SET NODE LC7 CIR LC-7L 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC7 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC7 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC7 CIR LC-7R 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC7 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC7 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LCB CIR LC-8 
NCP TELL RTR1GL USER [1,13 PASS PRIM LOOP NODE LC8 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC8 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC8 CIR LC-BL 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC8 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC8 CIR 

NCP TELL RTR1GL USER El, 13 PASS PRIM SET NODE LC8 CIR LC-8R 
NCP TELL RTR1GL USER El, 13 PASS PRIM LOOP NODE LC8 
NCP TELL RTR1GL USER El, 13 PASS PRIM CLE NODE LC8 CIR 

EXIT 
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c 

Summary of NCP Commands 



The following is a summary of all NCP commands that are useful for managing the 
DECnet Router Server. The SET NODE and DEFINE NODE commands are dis- 
cussed in Chapter 2. The LOAD NODE and TRIGGER NODE commands are dis- 
cussed in Chapter 5. For a discussion of the other commands, see the DECnet Router 
Software Management Guide. 

C.1 Setting up the Down-line Load and Up-line Dump Database 
on the Host 

Use the following privileged command to set up or modify the down-line load data- 
base on a loading host. On VMS hosts, use NCP. On RSX hosts, use CFE. 

NOTE 

When installing the server software on a loading host, you can use the 
installation command procedure (VMSINSTAL on VMS hosts or 
RSXINSTAL on RSX hosts) to automatically set up the database, as 
explained in Chapter 2. 

DEFINE NODE server-node-id NAME server-name 

DUMP FILE [uic]:server-node-id.DMP 
HARDWARE ADDRESS hex-address 
DIAGNOSTIC FILE [utc]:CSVLDI.SYS 
LOAD FILE [ui'c]:CSVRTR.SYS 
SERVICE CIRCUIT circuit-id 
SERVICE PASSWORD hex-password 
SECONDARY LOADER [uic]:PLUT02.SYS 
TERTIARY LOADER [utc] :PLUT03.SYS 

The uic is SYS$SYSTEM on VMS hosts and NETUIC on RSX hosts. 



) 
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C.2 Loading the Server Software 



Issue any of the following privileged commands at a host node for execution at the 
loading host. 

LOAD NODE server-node-id pFROM server -image- file 

HOST host-id 

SECONDARY LOADER file-id 
SERVICE PASSWORD hex-password 
TERTIARY LOADER file-id 

FROM server-image-file 
HOST host-id 

PHYSICAL ADDRESS hex-address 
SECONDARY LOADER file-id 
SERVICE PASSWORD hex-password 
TERTIARY LOADER file-id 



LOAD VIA circuit-id 



TRIGGER NODE server-node-id 



VIA circuit-id 

PHYSICAL ADDRESS E-address 
SERVICE PASSWORD hex-password 



TRIGGER VIA circuit-id 



PHYSICAL ADDRESS E-address 
[SERVICE PASSWORD hex-password] 



C.3 Remote Command Execution 

Use the following commands to cause commands to be executed remotely at the 
DECnet Router Server: 

SET EXECUTOR NODE server-node-id [PASSWORD password] 
TELL server-node-id ncp-command [PASSWORD password] 

Supply the network privileged password if the server requires it; that is, if the pass- 
word has been defined in the server's network configuration file. 

Use the following command to return NCP command execution to the local node. Use 
this command subsequent to issuing the SET EXECUTOR NODE command. 

CLEAR EXECUTOR NODE 
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C.4 Loopback Testing 



Use the following commands to test server and network components. You can execute 
them locally at the host or remotely at the server node. 



LOOP NODE node-id 



COUNT count 
LENGTH length 
WITH block-type 



LOOP CIRCUIT circuit-id ASSISTANT NODE node-id 

ASSISTANT PHYSICAL ADDRESS hex-address 
COUNT count 
HELP assistance-type 
LENGTH length 
NODE destination-node-id 
PHYSICAL ADDRESS destination-hex-address 
WITH block- type 

Use the following command to associate a node name with a circuit for loop node 
testing: 

SET NODE node-name CIRCUIT circuit-id 



C.5 Configuring and Controlling the DECnet Router Server 

Use the following privileged commands to change the operational state and cost of 
circuits on the DECnet Router Server. The KNOWN CIRCUITS keyword affects all 
circuits, including the UNA circuit. Therefore, be careful when using this keyword. If 
you turn off the UNA circuit, the server will be disconnected from the Ethernet. Issue 
the SET CIRCUIT command for remote execution at the server. 

SET (CIRCUIT circuit-id \ STATE state 
(KNOWN CIRCUITSJ COST cost 

Use the following to change the host (maintenance host) and receive and transmit 
passwords for the DECnet Router Server. (On VMS hosts, you cannot use the SET 
EXECUTOR command to change the passwords. Go to an RSX host.) Issue the 
command for remote execution at the server. 

SET EXECUTOR HOST node-id 

RECEIVE PASSWORD password 
TRANSMIT PASSWORD password 

Use the following command to change or define node names for nodes known 
to the server: 

SET NODE node-id NAME node-name 
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C.6 Monitoring the DECnet Router Server 

Use the following commands for monitoring purposes. Use the SET LOGGING and 
CLEAR LOGGING commands to change logging parameters. Use the SHOW com- 
mands to display information on command. Issue the commands for remote execution 
at the server. 



CLEAR [ KNOWN LOGGING 
< LOGGING CONSOLE 
^LOGGING MONITOR 



EVENTS events 
KNOWN EVENTS) 
ALL EVENTS 



SET f KNOWN LOGGING ^ ^EVENTS events 

< LOGGING CONSOLE > i KNOWN EVENTS] 
^LOGGING MONITOR J ^ 



CIRCUIT circuit-id 
LINE line-id 
NODE node-id 
SINK NODE node-id 



CIRCUIT circuit-id 
LINE line-id 
NODE node-id 
SINK NODE node-id 



SHOW ( AREA area-no 

i ACTIVE AREAS 

(known areasJ 1 1 summary 



If 



CHARACTERISTICS 
STATUS 



SHOW (ACTIVE CIRCUITS CHARACTERISTICS 
< CIRCUIT circuit-id > J COUNTERS 



I^KNOWN CIRCUITS J | 



J [TO file-id] 



STATUS 



I [SUMMARY 



(On RSX hosts, you can use the SHOW SIGNIFICANT CIRCUITS command.) 



SHOW EXECUTOR 



CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 



[TO file-id] 



SHOW [LINE line-id 

< active lines 
(known lines 



CHARACTERISTICS 
COUNTERS 
STATUS 
SUMMARY 



[TO file-id] 



(On RSX hosts, you can use the SHOW SIGNIFICANT LINES command.) 

SHOW f ACTIVE LOGGING (]7mARACTERISTICS~f| [TO file-id] 

J KNOWN LOGGING LI EVENTS I /SINK NODE node-id 

STATUS [ 1 KNOWN SINKS 

SUMMARY J J 

(On RSX hosts, you can use the SHOW SIGNIFICANT LOGGING command.) 



t LOGGING CONSOLE p 
LOGGING MONITOR J 
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SHOW ("ACTIVE NODES ^ ([CHARACTERISTICS | [TO file-id) 
ADJACENT NODES I J COUNTERS 
J KNOWN NODES fS STATUS 
] LOOP NODES I SUMMARY 

L.NODE node-id J 

(On RSX hosts, you can use the SHOW SIGNIFICANT NODES command.) 

Use the following privileged commands to clear counters kept for DECnet Router 
Server components. 

ZERO /CIRCUIT circuit-id \ [COUNTERS] 
\KNOWN CIRCUITS j 

ZERO EXECUTOR [COUNTERS] 

ZERO /KNOWN LINES\ [COUNTERS] 
\LINE line-id j 

ZERO /NODE node-id \ [COUNTERS] 
V KNOWN NODES J 
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Index 



A 



Access control verification, 4-3 
Account file maintenance program 

see ACNT 
ACNT, 2-23, 2-35 
Adaptive routing, 1-3 
Address 

area, 1-13 

Ethernet hardware, 1-9, 1-11, 2-4 
defining on RSX loading host, 2-29 
defining on VMS loading host, 2-8 

Ethernet multicast, 1-11 

Ethernet physical, 1-12 

extended DECnet node, 1-11 
Addressing, Ethernet, 1-11 
Addressing, multiple area network, 1-13 
Alternate loading host 

copying server files to, 5-20, 5-21, 5-22 
Area leakage, 3-14 figure 
Area number, 3-2 
Area parameters, 3-15 
Area partitioning, 3-15 
Area router 

see Level 2 routers 
Area routing, 1-12 to 1-13, 3-5 

benefits of, 1-13, 3-5 

defined, 1-1 

establishing support of, 3-9 
node addresses, 1-11 
on Ethernet, 3-14 



Areas 
defined, 3-5 

maximum number of, 4-13 
Asynchronous lines, 1-1 
identifying, 4-7 
numbering of, 4-9 figure 



B 

Backup host, 2-3 

as loading host, 5-20 

copying server files to, 5-20 

defined, 1-10 

specifying, 4-3 
on RSX loading host, 2-27 
on VMS loading host, 2-13 
Backup host list, 2-3, 2-13 

editing on backup hosts, 5-24 

setting up, 4-3 
Broadcast routers 

defined, 2-3, 4-13 

defining maximum number of, 4-17 
BRU, 2-18 
Buffer size 

changing in network, 4-19 

network guidelines, 3-3 
Buffer size parameter 

considerations, 4-12 

defining, 4-10 
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CFE, 2-17 

CFE DEFINE NODE command, 2-17 

summary, C-l 
CFE SHOW NODE command, 2-35 
Circuit 

cost, 4-20 
changing with NCP, C-3 

identifying, 4-7 

parameters, 4-20 to 4-22 

state, 4-22 
changing with NCP, C-3 
Clock frequency 

defining, 4-4 
on RSX host, 2-27 
on VMS host, 2-13 
Communications Server hardware unit 

see Ethernet Communications Server 
Configuration file, network 

creating on RSX loading host, 2-24 

creating on VMS loading host, 2-12 

description, 2-2 

example, 4-4, B-2 
Configuration file, router, 4-24 

customized example, 4-27, 4-34 

description, 2-2 

predefined (prototype), 2-2, 2-13 
example, B-2, B-9 
Configuration files 
changing parameters in, 4-1 
commands, 4-1 

editing after loading server, 5-24 

errors, 4-41, 5-10 

example, B-2 

examples, B-2 to B-16 

location of and protection, 2-157, 3-12, 

names of, 4-2 

on RSX loading host, 2-23, 2-34 
on VMS loading host, 2-15 
protecting, 2-2, 4-1, 5-24 
on RSX, 5-26 
on VMS, 5-25 
Configuration parameters 

changing, 4-1 
Configuring area networks, 3-5 to 3-18 
Configuring networks, 3-1 to 3-184, 4-2, 

general guidelines, 3-1 
Configuring the DECnet Router Server, 
4-1 



Controller 

see DEUNA, Ethernet controller 
Cost, 1-3, 4-20 

between areas, 4-14 

defining netowrk maximum, 4-17 
Crash 

troubleshooting, 6-4 
Crash dump 

see Up-line crash dump 
CSVLDI.SYS, 2-12, 2-14, 2-31 
CSVRTR 

defined, 2-5 
CSVRTR.SYS, 2-14, 2-31, 5-10 
CSVRTR16L.SYS, 2-7, 2-25 
CSVRTR32L.SYS, 2-7, 2-25 
CSVRTRICP, B-31 

see also Installation checkout 
procedure 

display example, on RSX host, B-32 

display example, on VMS host, 5-19, 
B-31 

invoking for installation checkout, 5-17 
CSVRTRICP.COM, 2-15 
CSVRTRICP16L 

display example, B-33 



D 

Database, down-line load 
commands for setting up, C-l 

Dataset 
see Modem 

DCSAX-LA (M3100) line cards, 1-7, 
4-24 

DCSAX-LB (M3101) line cards, 1-7, 
4-24 

DCSAX-LC (M3102) line cards, 1-7 
DDCMP, 1-7 
DECnet Phase III 

in multiple area networks, 3-7, 3-12, 
3-16 

routing, 1-5 
DECnet Phase IV 

routing, 1-3, 1-12 
DECnet Router Server, 1-3 figure, 1-4 
figure 

area parameters, 4-11, 4-13, 4-14, 4-15 
area routing, 3-10 
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DECnet Router Server (Cont.) 
benefits of, 1-5 

configuration files, 2-15, 2-34, 4-2, 

4-24, B-2 to B-16 
configuring, 4-1 
controlling and configuring 
command summary, C-3 
crash dump, 1-10 
defined, 1-1 
description, 1-1 to 1-5 
diagnostics, 1-9 

Ethernet hardware address, 1-11 

defining on RSX host, 2-29 

defining on VMS host, 2-8 
event logging, 1-10 
installation checkout procedure, 5-15 

to 5-20, B-31 
installing, 2-1 to 2-37 

see also RSXINSTAL, VMSINSTAL 

on RSX host, 2-17 to 2-37, B-23 
example 

on VMS host, 2-5 to 2-15, B-17L, 
VMSINSTAL example 
line cards, 1-7 

line configuration, 1-7, 1-8, 4-20 
loading, 5-2 to 5-9 
at the Ethernet Communications 
Server, 5-7 

by command (at host), 5-3, 5-4, 5-5,7, 2-30, 
5-6 

example, B-21, B-29 
preparations, 5-1 

using the NCP LOAD command, 5-3 
using the NCP TRIGGER command, 
5-4 

managing and maintaining, 1-10 
maximum message size, 4-19 
monitoring 

command summary, C-4 
node name 

defining on RSX loading host, 2-26 

defining on VMS host, 2-8 
node number 

defining on RSX loading host, 2-26 

defining on VMS host, 2-8 

displaying, 5-7 
parameters, 4-10 to 4-40 

defaults, 4-11 table 
remote node names, 3-2 
routing capabilities, 1-1 to 1-5 



DECnet Router Server (Cont.) 

routing database, 1-3, 4-10 

software image, 2-14, 2-31 

system image, 2-7, 2-24, 5-10 

troubleshooting, 6-1 
DECnet Router Server installation 

steps summarized, 2-1 
DECnet Router/X.25 Gateway, 4-21 
DECSA 

see Ethernet Communications Server 
DEFINE NODE command, 2-12, 2-17, 
C-l 

Designated router 

defined, 4-21 
Designated router (Cont.) 

function of, 3-4 
DEUNA, 1-7, 1-15, 2-4 
Diagnostics, 1-9 

Digital Data Communications Message 
Protocol 
see DDCMP 
Distribution kit 
backing up, 2-4 
copying to RSX host, 2-17 
copying to VMS host, 2-5 
installing onto host 
see also RSXINSTAL, VMSINSTAL 
Down-line load 

disk space requirements, 1-10 
Down-line load database 
checking contents, RSX, 2-35 
checking contents, VMS, 2-11 
commands for setting up, C-l 
setting up on RSX host, 2-17, 2-30, 
2-31, 2-32 figure 
command file, 2-29, 2-30 
setting up on VMS host, 2-8, 2-10 
figure, 2-12 
command file, 2-11 
DUPLEX parameter 
defining, 4-23 

E 

End nodes, 1-2 

maximum number of, 4-16 
Errors 

see also Events, Event messages 
configuration file, 4-41 
during loading, 5-10 
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Ethernet, 1-15 to 1-16 

see also LAN 

area routing on, 3-14 

configuration guidelines, 3-3 

defined, 1-15 

node addresses, 1-11 

routers and end nodes, 3-4 
Ethernet circuit 

see UNA circuit 
Ethernet Communications Server, 1-1, 
1-6 figure 

description, 1-6 to 1-9 

diagnostics, 1-9 

front panel description, 1-9 

installing, 2-4 

line cards, 1-7, 4-8 figure 

line configuration, 1-7 

loading software, 5-2, 5-7, 5-8 figure, 
5-9 figure 
Ethernet controller, 1-7, 1-15 

addressing, 1-11, 1-12 
Ethernet hardware address 

defined, 1-11 

defining on RSX loading host, 2-29 

defining on VMS loading host, 2-8L, VMSINSTAL 

display of, 1-9, 2-4 
Ethernet multicast address, 1-11 
Ethernet node 

address, 1-11 

addressing of, 1-11 

hosts, 1-10 

loading host, 1-10 
Ethernet physical address, 1-12 
Ethernets, interconnection of, 4-23 
Event logging, 1-10 

command summary, C-4 

enabling on loading host, 5-2 

obtaining information about, C-4 
Event messages 

during load from RSX host, 5-13, B-29 

during load from VMS host, 5-11, 
B-21 

Executor node parameters, 4-10 to 4-19 
Extended DECnet node address, 1-11 



F 

Files 

see also Network configuration file, 

Router configuration file 
copying to other loading hosts, 5-20 
copying to RSX loading host, 2-17 
copying to VMS loading host, 2-5of server, 

H 

Halt error, 4-41 
Hardware address 

see Ethernet hardware address 
Hardware controller 

see also DEUNA 
Hello message, 4-21 
HELLO TIMER parameter 

defining, 4-21 
Hop, 4-18 

between areas, 4-15 
Host, 1-10, C-l, C-3 

backup, 2-3, 2-13 

defined, 1-10 

requirements, 1-10 
Host, loading, 2-1 



I 

ICP 

see Installation checkout procedure 

Initialization tasks, 4-1 

Installation, 2-1 to 2-37 
see also RSXINSTAL, VMSINSTAL 
disk space requirements, 2-5, 2-17 
of additional DECnet Router Servers, 
2-2 

on RSX host, 2-17 to 2-37 

example, B-23 
on VMS host, 2-5 to 2-15 

example, B-17 
preparation, 2-3 
steps summarized, 2-1 



lndex-4 



Installation checkout procedure, 5-15 to 
5-20 
invoking, 5-15 
RSX example, B-32 
synchronous/asynchronous lines, B-33 
VMS example, 5-19, B-31 

K 

Known nodes 
defining names of, C-3 

L 

LAN, 1-15 to 1-16 

see also Ethernet 

defined, 1-15 
LC circuit 

event messages during load of server, 
5-12 

not on after load, 6-3 

on-starting after load, 6-4 
LC circuit up message during load, 5-12, 

5-15 
LDI, 2-12, 2-14 
Leased line, 1-9 
Level 1 routers, 3-7 to 3-8 

defined, 1-2, 3-5 
Level 1 routing, 3-5 
Level 2 routers, 3-7 to 3-8 

defined, 1-2, 3-5 

establishing, 3-10 
Line 

and modems, 4-23 

assigning cost, 4-21 

asynchronous point-to-point, 1-1, 1-7 

dial-in, 1-9 

identifying, 4-7 

leased, 1-9 

numbering scheme, 4-8 figure 
parameters, 4-22 to 4-24 
synchronous point-to-point, 1-1, 1-7 



Line cards 
DCSAX-LA (M3100), 1-7 
DCSAX-LB (M3101), 1-7 
description, 1-7 

maximum configuration, 1-8, 4-20 

numbering of, 4-8 figure 

removing or replacing, 1-9 
Line configuration, 2-7, 2-24 
Line configuration worksheet, 2-3, A-l 

example to A-2 example 
Line speed 

defining, 4-24 
Listen timer, 4-21 
LOAD command 

see NCP LOAD command 
Load, down-line 

disk space requirements, 1-10 
Loadable diagnostics image 

see LDI 
Loading host, 2-1 

see also Alternate loading host 

defined, 1-10 

disk space requirements, 2-5, 2-17 
down-line load database, 2-8, 2-29 
requirements, 1-10 
up-line dump database, 2-8, 2-29 
Loading the DECnet Router Server, 5-2 
to 5-9 

at the Ethernet Communications 

Server, 5-7 
by command at loading host, 5-3, 5-4 
codes displayed during, 5-7 
command summary, C-2 
errors during, 5-10 
event messages displayed, 5-10 
from RSX host 

example, B-29 
from VMS host 

example, B-21 
preparations, 5-1 
process described, 5-10 
troubleshooting, 6-1 
using NCP TRIGGER command, 5-4 
using the NCP LOAD command, 5-3 
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Local area network 
see LAN 

Local Area Transport (LAT), 3-11 
LOCK position, 5-7 
Loop node 

command for setting up, C-3 
LOOP NODE command 

see NCP LOOP NODE 
Loop node name, 5-18 
Loopback test 

command summary, C-3 

for checking out installation, 5-18 

M 

M3100 line cards, 1-7 

see also DCSAX-LA line cards 
M3101 line cards, 1-7 

see also DCSAX-LB line cards 
Maintenance host 

changing with NCP, 2-9, C-3 

defined, 1-10 

defining on RSX host, 2-31 
defining on VMS loading host, 2-9 

Maximum address, 1-13 

MAXIMUM ADDRESS parameter, 3-3, 
4-13 

MAXIMUM AREA COST parameter, 

3-15, 4-14 
MAXIMUM AREA HOPS parameter, 

3- 15, 4-15 

MAXIMUM AREA parameter, 3-15, 

4- 13 

MAXIMUM BROADCAST 

NONROUTERS parameter, 3-3, 3-4, 
4-16 

MAXIMUM BROADCAST ROUTERS 

parameter, 3-3, 3-4, 4-17 
MAXIMUM COST parameter 

defining, 4-17 
MAXIMUM HOPS parameter 

defining, 4-18 
Modem, 1-9, 4-23 
Modem eliminator, 1-9 
MODEM parameter 

defining, 4-23 
Monitoring the DECnet Router Server 

command summary, C-4 



Multicast address 

see Ethernet multicast address 
Multiple area network, 1-14 figure, 3-6 
figure 

area routing, 1-12 

benefits of, 1-13 

configuration guidelines, 3-5 to 3-18 
configuration problems, 3-15 
defined, 1-1 
design guidelines, 3-11 



N 

NCP 

changing routing parameters with, 4-5 

command summary, C-l to C-5 
NCP CLEAR LOGGING command 

summary, C-4 
NCP DEFINE NODE command, 2-8, 
2-12 

summary, C-l 
NCP LOAD command, 5-3 

fails to load server, 6-2 

issuing while TEST button in, 5-3 

loading the server, 5-4 figure 

summary, C-2 

using, 5-3 
NCP LOAD VIA command 

summary, C-2 
NCP LOOP CIRCUIT command 

command summary, C-3 
NCP LOOP NODE command 

for installation checkout, 5-18 

summary, C-3 
NCP SET CIRCUIT command 

summary, C-3 
NCP SET EXECUTOR command 

summary, C-3 
NCP SET EXECUTOR NODE 
command 

summary, C-2 
NCP SET LOGGING command 

summary, C-4 
NCP SET NODE command, C-3 

for setting up loop node, C-3 
NCP SHOW AREA command 

summary, C-4 
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NCP SHOW CIRCUIT command 

summary, C-4 
NCP SHOW EXECUTOR command 

summary, C-4 
NCP SHOW LINE command 

summary, C-4 
NCP SHOW LOGGING command 

summary, C-4 
NCP SHOW NODE command 

summary, C-5 
NCP TELL command 

summary, C-2 
NCP TRIGGER command, 5-3 

fails to load server, 6-3 

loading the server, 5-5 figure, 5-6 
figure 

summary, C-2 

using, 5-4 to 5-7 
NCP TRIGGER VIA command, 5-4 

summary, C-2 
NCP ZERO CIRCUIT COUNTERS 
command 

summary, C-5 
NCP ZERO EXECUTOR COUNTERS 
command 

summary, C-5 
NCP ZERO LINE COUNTERS 

command, C-5 
Network 

see LAN, Multiple area network 
Network configuration file 

checking contents, 2-35 

creating on RSX loading host, 2-24 

creating on VMS loading host, 2-12 

description, 2-2 

editing, 4-2 to 4-4, 5-24 

errors in, 5-10 

example, 4-4, B-2 

name of on loading host, 4-2 

on backup hosts, 5-24 

parameters, 4-2 
defining on RSX host, 2-24 
defining on VMS host, 2-12 

protecting, 5-24 
on RSX, 5-26 
on VMS, 5-25 
Network management, 1-10 



Network privileged password 
defining, 4-3 

defining on RSX loading host, 2-27 

defining on VMS loading host, 2-12 
Network topology, 2-3 
Node address, 3-1 

and area support, 3-9 

in multiple area network, 1-11, 1-13 
Node name, 3-1, 3-2 

changing, 3-2 

defining for nodes known to server, C-3 
Node number, 3-2 

in multiple area network, 1-13 
Nodes 

identifying, 3-1 

maximum number of, 4-13 
Nonrouting nodes, 1-2 

maximum number of, 4-16 
Null modem, 4-23 

P 

PAM 

defined, 1-7 
Password 

see Service password, UNA password, 
Network privileged password, 
Receive password, Transmit 
password 
Path cost 
calculating, 4-20 
defined, 4-17 
Permanent database, RSX loading host 

showing contents, 2-35 
Phase III DECnet 

see DECnet Phase III 
Phase IV DECnet 

see DECnet Phase IV 
Physical address 

see Ethernet physical address 
PIP, 2-18 
PLUTO account 
creating on RSX loading host, 2-17, 
2-23 

creating on VMS loading host, 2-7 
log-in command file 

example, 5-25 

protection of, 5-26 
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PLUTO account (Cont.) 

on RSX host, 2-22, 2-23 

protecting on RSX host, 2-37, 5-26 

protecting on VMS host, 5-25 

setting up on RSX loading host, 2-35 
PLUT02.SYS, 2-14, 2-31 2 routers 

loading of, 5-10 
PLUT03.SYS, 2-14, 2-31 

loading of, 5-10 
PLUTOCC.SYS, 2-14 
PLUTOWL.SYS, 2-14 
Power failure, 1-10 
Primary loader, 5-10 
Protecting configuration files, 5-24 

on RSX loading host, 5-26 

on VMS loading host, 5-25 
Protocol Assist Module 

see PAM 

R 

RCF 

image on RSX loading host, 2-34 

image on VMS loading host, 2-14 
Reachable nodes 

defined, 4-17 

determining, 4-17, 4-18 
Receive password, 3-10, 3-13 

changing with NCP, C-3 

defining, 4-18 
Receive speed, 4-24 
Remote command execution 

command summary, C-2 
Router configuration file 

commands, 4-5 

customized example, 4-24, 4-34 
defined, 2-13 
description, 2-2, 4-5 
editing, 2-13, 4-5 to 4-9, 5-24 
errors in, 5-10 

name of on loading host, 4-2 
predefined (prototype), 2-2, 2-13 

example, B-2, B-9 
protecting, 5-24 

on RSX, 5-26 

on VMS, 5-25 
Router Server 
see DECnet Router Server 



Routing, 1-1, 1-3 

see also Area routing 

DECnet Phase III, 1-5 

DECnet Phase IV, 1-3, 1-12 

in multiple area networks, 1-12, 3-5 
Routing database, 4-10 

changing, 4-5 

defined, 1-3 

obtaining information about, 4-6 

parameters, 4-11 table 
Routing nodes 

see also Level 1 routers, Level 2 routers 

configuration guidelines, 3-4 

defining maximum number of, 4-17 

level 1, 3-5 

level 2, 3-5 
Routing parameters, 4-10 

changing, 4-5 

obtaining information about, 4-6 

table, 4-11 
ROUTING PRIORITY parameter 

defining, 4-21 
RSX-11M/M-PLUS hosts, 1-10 
RSXINSTAL 

description, 2-17 

dialog (display), B-23 

dialog (display), with explanation, 2-21 
to 2-34 

invoking, 2-20 

performing, 2-19 

s 

Secondary loader 

loading of, 5-10 
SEGMENT BUFFER SIZE parameter 

changing in network, 4-19 

defining, 4-19 
Segment size, 4-10 
Self-test 

see Diagnostics, LDI 
Server hardware unit 

see Ethernet Communications Server 
Server initialization tasks, 4-1 
Server initializing event message, 5-10, d, 5-2 
5-12, 5-14 

on RSX host, B-30 

on VMS host, B-22 
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Server node 

defined, 2-1 
Server node name 

defining on RSX loading host, 2-26 

defining on VMS loading host, 2-8 
Server node number 

defining on RSX loading host, 2-26 

defining on VMS loading host, 2-8 

displaying, 5-7 
Server system image 

loading of, 5-10 
Server up event message, 5-10, 5-13, 
5-15 

on RSX host, B-30 

on VMS host, B-22 
Server, DECnet Router Server 

see DECnet Router Server 
Service circuit 

defining on RSX loading host, 2-29 

defining on VMS loading host, 2-9 
Service password, 2-9, 4-2 

defining on RSX loading host, 2-27 

defining on VMS host, 2-9 

specifying with NCP LOAD NODE 
command, 5-3 

specifying with NCP TRIGGER 
command, 5-4 
SPEED parameter 

defining, 4-24 
Synchronous lines, 1-1 

identifying, 4-7 

numbering of, 4-8 figure 
System password 

see Network privileged password 

T 

Tertiary loader 

loading of, 5-10 
Transceiver, 1-15 
Transmit password, 3-10, 3-13 

changing with NCP, C-3 

defining, 4-19 
Transmit speed, 4-24 
TRIGGER command 

see NCP TRIGGER command 
Troubleshooting, 6-1 to 6-4 



u 

UNA circuit, 4-21 
enabling for down-line load, 5-2 
identifying, 4-7 
turning off, C-3 

turning on for load of server, 5-1 
UNA controller 

see Ethernet controller, DEUNA 
UNA line 

identifying, 4-7 

loading, 5-1 
UNA password, 2-9 

defining, 4-2 

defining on RSX loading host, 2-27 

defining on VMS loading host, 2-9 
Unreachable nodes 

defined, 4-17, 4-18 
Up-line crash dump 

disk space on host, 1-10 
Up-line crash dump database 

setting up on RSX loading host, 2-29 

setting up on VMS loading host, 2-8 
Up-line dump database 

commands for setting up, C-l 



V 



VAX/VMS hosts, 1-10 
VMS hosts, 1-10 
VMSINSTAL 

dialog (display) with explanation, 2-5 
to 2-14 

invoking, 2-5 

performing, 2-5 

sample dialog, B-18 



X 



X.25 Gateway, 4-21 
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